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What can't you do with a $35 computer? 


CREATE A SATNAV ROBOT 


Discover precision robotics with Big Rob 


DESIGN A DOG 
TREAT DISPENSER 


Keep Scooby in snacks with 
this clever pet project 


BUILD A GPS 
TRACKING DEVICE 


The ultimate movement tracker 
for land and sea adventures 


MASTER BLUETOOTH 


Take control of your Raspberry Pi remotely 


{llso insides 


USE A SENSE HAT WITH MATHEMATICA 
REVIEWED! THE BEST WEB BROWSER FOR PI | 

ncredible outdoor 
CREATE ELECTRONIC SENSOR WIND CHIMES Aipialerelectarer 
BUILD THE WORLD'S SMALLEST CONSOLE open-air fun 


Don't leave your Pi in the shade! 


Canakit ch 


CanaKit Raspberry Pi 3 Ultimate Starter Kit 
Model B | 1 GB RAM | 1.2 GHz | Quad-Core CPU 


> Learn to Code 
> Explore Computing 
> Get started with Electronics 


Kit INCLUDES RASPBERRY P! 3 AND... 


2.5A 
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32 GB CLAss 10 
MicroSD CARD 


USB MicroSD 
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WELCOME TO 
THE OFFICIAL 
MAGAZINE 


any people stare all day at their phone 
screens, and never think to ask what’s going 
on behind the glass. We want computers we 
can hack, make, and break (and for it not to matter), 
and that’s exactly why we love the Raspberry Pi. 

The Raspberry Pi is about GPIO pins and wires, and 
the Linux OS. It’s about making something, and 
messing up everything, and it not mattering because 
there’s always another chance. 

We love it. 

But what would it be like to use all the time? 
Would using a Raspberry Pi every day of the week be 
digital heaven, or computing hell? That’s the task 
we set our intrepid Features Editor Rob Zwetsloot. 
Spend a week working with a Raspberry Pi — nothing 
else allowed. And let us know what it’s like: warts 
and all. You can read all about it on page 16. 

The Raspberry Pi is a glorious piece of kit, and 
it’s ashame to keep it in the shade. It is perfectly 
portable and ideal for aerial balloons, outdoor 
cameras, weather stations, and all manner of 
fresh-air projects. We have twelve amazing Summer 
projects for you, starting on page 68. 

So whether you’re installing a Raspberry Pi 
permanently in your home, or taking it outside 
to play, what’s important is that you’re using the 
world’s most interesting computer. And let us know 
how you get on. 


Lucy Hattersley 
Editor - The MagPi 
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MASTER BLUETOOTH 


SEE PAGE 30 FOR DETAILS 
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16 THE RASPBERRY PI PC CHALLENGE 


Can you really use a Raspberry Pi as a desktop replacement? 


42 GET STARTED WITH GIT 


Use Git to clone, copy, and contribute to code 


90 BLUE DOT BLUETOOTH 


Adding Bluetooth control to your projects has never been easier 


68 SUMMER PROJECTS 


Twelve incredible outdoor digital projects to make 
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TUTORIALS 


> PI 101: SENSE HAT EMULATION 40 


How to create and test code for the Sense HAT 


> PI 101: GET STARTED WITH GIT 42 


Manage your code repositories the easy way 


> CREATE A GPS TRACKER 48 


Track your travels with this nautical project 


> ADD BLUETOOTH CONTROL 00 


Use Blue Dot to control Bluetooth devices 


> USE SENSE HAT WITH WOLFRAM 954 


Analyse and display your data with Mathematica 


> BUILD WIND CHIMES 06 


This month's Pi Bakery makes wind-powered music 


> ADD SERVOS TO AIY PROJECTS 60 


Use the AIY Projects Voice HAT to control servos 


> USE MOTORS WITH VOICE HAT 62 


Servos not enough for you? Let's add some motors! 


CODERDOJO AND 
RASPBERRY Pl 


| 
Ss 


Two Foundations join forces 
to bring coding to young people 
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Our friends at Dexter 
Industries launch 
a new robot 
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Meet awesome YouTuber Estefannie 
Not our Features Editor, but a GPS-controlled robot! 
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Below Philip 
Colligan (left), CEO 
of the Raspberry 
Pi Foundation, 

and Giustina 
Mizzoni (right), 
Executive Director 
of the CoderDojo 
Foundation 


Teaming up to deliver more for young makers and coders 


he Raspberry Pi 
) Foundation and the 
CoderDojo Foundation 
have merged, with Raspberry Pi 
Foundation CEO Philip Colligan 
joining the CoderDojo board. The 
two Foundations will share back- 
office resources and expertise 
to deliver more quickly on their 
shared goals. 
CoderDojo fans won’t see any 
change at the Dojos, however. 


CoderDojo spokesperson Rosa 
Langhammer tells us that 
“CoderDojo is and will always 
remain 100% content, software 
and hardware neutral! 

“The Raspberry Pi Foundation 
works to put the power of digital 
making into the hands of people 
all over the world,” continues 
Rosa, “and the CoderDojo mission 
is to give every young person an 
opportunity to learn and create 


with technology. By combining 
our efforts we get closer to these 
shared goals.” 

The merger will allow CoderDojo 
to reach even more young, 
enthusiastic makers and coders. 
We’ ll hear more about these 
plans in the summer, but Rosa did 
reveal that part of the strategy 
review includes “mapping the 
path to 5,000 Dojos [worldwide] 
by 2020." 
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Any hardware and software is fine, as long as you're coding 


But, “the first priority,” Philip 
tells us, “is to make it as easy 
as possible to set up and runa 
CoderDojo. That means investing 
in the tools and resources that 


to support the growth of the 
CoderDojo movement around 
the world.” 

“The CoderDojo Foundation 
team is really excited,” says 


We decided we should join 
forces to accelerate the growth 
of the CoderDojo movement 


CoderDojo champions and 
mentors need.” 

Enabling more people and 
businesses to set up Dojos won’t 
be easy. That’s why the Raspberry 
Pi Foundation will be “bringing all 
of the capabilities and expertise 
of the Raspberry Pi Foundation 


Rosa, “and is looking forward 
to working with a wider team 
of people with similar goals, 
cooperating on new projects 
and pooling all our experiences 
and talents to give more people 
the opportunity to learn and be 
creative with technology.” 


A Dojo in action, with experts and mentors helping kids make and code 


raspberrypi.org/magpi 


os 


Aimed at young people between the ages of 

7 and 17, CoderDojos are free, community-led 
programming clubs for anyone curious about 
coding. Whether that's building websites, apps, 
or just figuring out how technology works, Dojos 
have always offered freedom from hardware and 
software restrictions - any tool is fine, as long as 
you're coding. 

“The CoderDojo mission is to give every young 
person an opportunity to learn and create with 
technology,” as spokesperson Rosa Langhammer 
puts it. 

Key to the movement are the volunteer 
‘Champions’ who set up the Dojos. If you or your 
organisation would like to set up a Dojo, the 


CoderDojo Foundation will help you get started: 
visit magpi.cc/2r4EnVT for details. You don't need 
technical skills to start a verified Dojo, just the ability 
to bring people together, and a passion for the 
power of code to build a positive future. 

To search for a Dojo near you, check the 
interactive map at zen.coderdojo.com. 


© CoderDojo 


Perfect timing 

Why now? “In a word: demand,” 
Philip explains. “We know that 
young people all over the world are 
crying out for places they can go 
to learn how to get creative with 
digital technologies. Education 
systems aren’t responding quickly 
enough to that demand, so we 
decided that we should join forces 
to accelerate the growth of the 
CoderDojo movement.” 

Both Foundations were 
established at around the same time, 
and “we’ve been working together 
in lots of ways from the beginning,” 
says Philip. “Lots of the people 
who are CoderDojo champions and 
volunteers are also members of the 
Raspberry Pi community.” He also 
confirms that “we have no plans 
to change the approach to Code 
Club or CoderDojo; our priority is 
encouraging the growth of both 
initiatives all over the world.” 
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EVERY 
DEVICE? 


Eben Upton speaks at the first ever Global Digital Signage Conference 


aspberry Pi co-founder With about 14 million Pis shipped However, machine-to-machine 
Eben Upton was a key in the last five years, he sees more interactions offer — according 
speaker at the recent scope for industrial IoT applications to Eben - almost limitless 
Global Digital Signage Conference. | than consumer IoT products. possibilities to use a Raspberry Pi. 
One attendee had flown in from “There’s a limit to how many things For example, many of the screens 
Brazil just to hear him speak. you can interact with if you have in airports now are powered by Pi 


Compute Modules. 


loT and security 


We took a network that was designed 
to be resilient to nuclear war and we ace pincer ae 


made it vulnerable to toasters ee ee 


made it vulnerable to toasters.” 


Host, and DailyDOOH editor a human in the loop.” Eben listed However, security tends to get 
(dailydooh.com) Adrian Cotterill, a Nest-like thermostat, lighting “squeezed”, because “you don’t 
asked about Pi sales. “We’re selling controller, and security system: need it until you need it.” Further, 
Eben Upton's about halfamillionunitsamonth, “My house is probably never going “potentially the guy who doesn’t 
et eal of the $35 flagship product,” to have more than three or four invest in security beats the guy who 
Signage Conference replied Eben. consumer IoT devices.” did invest in security to market.” 


Eben sees IoT makers eventually 
opting for acompany such as 
Amazon to provide an easy 
and robust security service. 
However, “I think it’s going to be 
a while before this stuff becomes 
really trustworthy.” 


UHD Pi? 


Asked when we might see a 
Raspberry Pi capable of Ultra High 
Definition (4K) output, Eben said 
it was “forward in our minds” but 
dismissed the use of a separate 
eraphics chip. “The only rationale 
for a second chip would be 
thermal... you bake in a lot of cost 
if you do that.” Eben estimated 
that “it’s probably four or five 
years” before we’d see a UHD Pi. 
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MAKE YOUR OWN RASPBERRY PI NETWORK MUSIC SYSTEM 
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YOU'LL NEED: 


¢« WD PiDrive Node Zero 
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¢ 90-Watt Class T 
Hi-Fi Stereo Amplifier 


e Pi Music Box Software 


¢ Visit our Instructable page 
for the full list! 


Join WDLabs and Maker Project Lab to learn how to build and code a 
dedicated digital sound system! With a Raspberry Pi Network Music System, 
you can centralize your music files and even stream continuously from your 
favorite music service, all for less than $100. 


Get step-by-step instructions 
@ WDLABS at wdlabs.io/instructables59 


Western Digital and the WDLabs logo are registered trademarks or trademarks of Western Digital Corporation or its affiliates in the U.S. and/or other countries. HDMI and the HDMI logo are trademarks or registered trademarks 
of HDMI Licensing LLC in the United States and other countries. Raspberry Pi is a trademark of the Raspberry Pi Foundation. All other marks are the property of their respective owners. As used for storage capacity, one gigabyte 
= one billion bytes. Total accessible capacity varies depending on operating environment. Product and price specifications subject to change without notice. Pictures shown may vary from actual product. 

© 2017 Western Digital Corporation or its affiliates. 


IS FINALIST FOR PRESTIGIOUS 


Awards Dinner 2016 


RELEASED 


Updated robot car kit ‘more versatile than ever’ exter Industries has launched the third version 
of its popular GoPiGo robot car kit, along with 
“a whole new operating system, DexterOS, 
— we _— : designed specifically for learning how to program 
Oo": & } robots intuitively.” 
fi & The new kit has an updated sensor board, with ports 

including “two I?C and two AD (analogue or digital), 
one Serial, two servo. Everything is a lot more robust 
so you can daisy-chain and add on easily.” 

Dexter Industries’ Taryn Sullivan says that the 
GoPiGo3 is “totally redesigned and we’ve added a 
lot of features that will be great for educators.” The 
DexterOS software allows you or your students to build 
code in Bloxter (based on Google’s Blockly) or Python, 
and is compatible with the GoPiGo2. 

The GoPiGo3 should be on sale in the UK by 
the time you read this, from suppliers such as 
ModMyPi (www.modmypi.com). The price has 
yet to be confirmed, but we expect it to be around 
£,95-100 (Pi-less). 
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PI-POWERE 


Welsh company delivers open-source smart 
appliance and accessories 


penEnergyMonitor’s homeowners have four different 

Pi 3-based emonPi tariffs during each day, depending 

monitors your energy on the behaviour of the nearby 
use in real time, and coordinates hydroelectric generator. “When 
all your smart- and eco-tech. the hydro is running, their energy 
Co-founder Glyn Hudson told us bills are very, very low.” 
about the company’s latest project, Hudson wanted an intuitive 
the emonPixel. display for the current tariff, so he 

“For many years we’ve had developed the emonPixel. Based on 

a little LCD display called the a NeoPixel ring, the emonPi control 
emonGLCD. But it doesn’t give a hub monitors the energy supply in 
whole lot of information.” Hudson _ real time, and turns quarters of the 
informed us about his work with ring either red or green. If the ring is 
Energy Local (energylocal.co.uk), fully red, don’t use the tumble dryer! 
and a group of homes in North The emonPixel should be on 
Wales, to develop a better energy sale soon — see magpi.cc/2qYYukc 
monitoring system. These for details. 


Below The guts of the new energy display: a NeoPixel ring with wireless capability 
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NOW TRENDING 


The stories we shared that 
flew around the world 


PIDRIVE NODE ZERO 
magpi.cc/2s6L21v 


Western Digital has released a cunning caddy that 
snugly combines a Raspberry Pi Zero with a 314GB 

PiDrive hard disk. Use it as a neat and low-powered 
NAS or file storage device. 


+ 
HACK AN AMAZON DASH BUTTON 


magpi.cc/2rwtTxP 


With a bit of craft and Python code, you can hack 

one of Amazon's £5 Dash Buttons to do pretty much 
anything you like. We use ours to switch on our LIFX 
smart lights. 


PROGRAM MINECRAFT ON A Pl 


magpi.cc/2sit2RT 


Our comprehensive guide to programming and 
hacking in Minecraft Pi Edition is an ideal starting point, 
whether you're playing, or using the game to learn 
coding in an exciting way. 
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PLUG & PLAY 


Pre-soldered Pi Zero W 


nline retailer Pi Supply (pi-supply.com) has 

released a Raspberry Pi Zero W with a GPIO 

header. This is a boon for solder-averse 
hobbyists and lazy makers alike, especially as the pre- 
soldered Pi costs only £14. Visit magpi.cc/2sUWhds 
for details. 

Pi Supply owner Aaron Shaw tells us, “We think the 
Raspberry Pi Foundation absolutely did the right thing 
by not including a header as standard because it’s 
unnecessary for many projects and adds a significant 
cost! However, for some projects this is an annoyance 
and a header is needed.” 


ulia has been ported to the Pi, allowing 
scientific researchers, data analysts and 
hobbyists alike to experiment with the 
next-gen programming language. 
Viral Shah, co-creator of Julia, explains to us that 
“workstations crunching data is the typical picture” 
for scientific computing, but “I just got myself a Pi 3 


Julia running 
onaPiwitha 
Sense HAT 


Al\\ : — “ See . i 
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~re IE 
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Get making 
straight away with 
Pi Supply's pre- 
soldered Pi Zero W 


Shaw says that pre-soldering the GPIO header 
“turns the Pi Zero into something completely plug 
and play, the minute it falls through the post box. 
And we test them before they ship out.” 

We wondered who was doing all the laborious 
soldering: “For the first 100 units, we did these by hand 
between four of us... we have now outsourced it to our 
lovely contract manufacture partners based in the UK.” 

The pre-soldered Pi was first listed on 12 May 
and “they have been selling fantastically well.” 
Pre-soldered or not, you can still only buy one Pi 
Zero W per order. 
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Julia can be used for less serious applications as well as more 
complicated tasks. Image: JuliaCon 2016 
and a Sense HAT. With all the computing power and 
sensors there, it makes sense to crunch data on the 
device itself.” 

Julia isn’t just for scientific analysis, crunching 
huge data sets, or statisticians, though. “Julia was 
designed to solve the two-language problem: the 
speed of C++ and Fortran with the ease of use of 
Python. There are increasingly many application 
domains where Julia is a great fit.” We’ve seen 
demonstrations of Julia being used to hack Minecraft, 
and to build the AI in an autonomous RC race Car. 
Julia currently offers support for the Pi’s GPIO, 
the Sense HAT, and Minecraft Pi. 

To start playing with Julia, follow the download 
instructions at juliaberry.github.io. 
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MEDICAL RESEARCH TOOL fy /277 


PI CLUSTER POWERS Jf . =e 
NEXT-GEN MEDICAL (i minyT ga s¢ 
RESEARCH TOOL 


Semantic search meets affordable hardware 
for the glo 


sciences If 


K-based SciBite recently demonstrated its 
cutting-edge biomedical semantic search tools 
ona humble Raspberry Pi cluster. 

The demonstration was part of SciBite’s setup for the 
Bio-IT World show in Boston, USA, where SciBite won an 
award for Best of Show in the Analysis and Data Computer 
category. “The show went really well,” SciBite marketing 
manager Monica Kulkarni tells us, with a “great reception 
for the Pis. People came to the stand just to see the demo. 

“The great thing about using the Pi cluster,” 

Monica continues, “was that when the internet 
connection went down in the exhibition hall, we could 
carry on demonstrating, as the Pis ran on their own 
local network.” 

‘Semantic search’ is a method of information gathering 
far in advance of using a standard search engine, Monica 
explains. “Controlled scientific vocabularies” allow the 
TERMite semantic search tool to understand that “for 
any given concept, there may be multiple synonyms 
for a singular term. Schilder syndrome, Alpers’ disease, 
Christensen disorder, Encephalitis periaxialis are all 
the same disease.” The “tens of millions of synonyms 
provide the depth of knowledge required to understand 
biological text.” ~ 

However, ambiguity is also a problem, with a single ey G 
word having many meanings, and therefore producing G O O 
either irrelevant or misleading search results. “Contextual 20+ new 0 roj ects for your Pj robot car. 
disambiguation is critical to ensuring accurate insight,” 2 ee eee 
confirms Monica. | - 

TERMite, and the DOCstore front-end that accesses 
it, is platform-agnostic (it’s a Java app with a browser- 
based UI), but developing for the Pi wasn’t just for fun. 
Squeezing the TERMite vocabularies to run on the Pi’s 1GB 
of RAM was a challenge, but “some of the techniques we 
used to compress and efficiently scan data... are already 
finding their way into next release of TERMite.”’ 


fe 
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Above A cluster of four Raspberry Pis in a master-slave configuration 
hosts and executes SciBite’s next-gen search tool 
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pi-topOS 


Learn. Play. Create 


pi-topCODER 


The OCR* endorsed pi-topOS 
(Operating system) platform comes 
pre-installed on the 8GB SD card 
shipped with every unit. pi-topOS 
software suite lets you - browse the 
web, - check emails, - create and 
edit Microsoft Office compatible 
files. It includes pi-topCODER and 
comes with the revolutionary 
educational game CEEDuniverse. 


Quick Launch Notes 
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| pi-topCODER is the interface that 
mm a allows you to access worksheets 
and pre-built Raspberry Pi projects. 
It's the easiest way to tinker or 
deliver lessons by providing 
step-by-step guides for computer 
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pi-top 


WWW.PI-TOP.COM 


pi-topCEED 


The modular all-in-one 
Raspberry Pi powered desktop 


K Adjustable 
Viewing Angles 


14° 


HD Screen 


ay Modular 
= Components 


oe 
* 
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pi-top 


The modular build-it-yourself 
Raspberry Pi powered Laptop 


Q 10 Hour 
Battery Life 


13.3" 
HD Screen 


emg = Modular 
-—_ Components 


uo 
e to Worldwide shipping available in green or grey at www.pi-top.com or our distributors 
Stay up to date with our latest news by following our social media 


he desktop computer is a dying breed these 

days, especially in the home. With the 

arrival of powerful laptops and convenient 
tablets, fewer people feel the need to have a dedicated 
desk computer taking up space or gathering dust in 
their house. 

A good desktop computer can be useful, particularly 
for work-related tasks, but for many people space is 
at a premium. What better computer to turn to than 
the credit-card-sized Raspberry Pi? We’ve claimed 
several times that you can use the Raspberry Piasa 
desktop PC, so it’s time to put this to the test and use 
a Raspberry Pi for a whole week — for science! 


pat Rib 
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wm "RG Mme Cebe> _ 
ie %: er = For one week, I'll be working 
, = on a Raspberry Pi. I've chosen 
the Raspberry Pi 3, as it’s the 
most powerful Pi to date, and 
I'm going to need all the power 


| can get. 


My test used wireless LAN 

for internet access, but you 
can easily wire up an Ethernet 
connection if you prefer. 


The classic desktop setup isn't 
complete without the standard 
mouse and keyboard - no 
touchscreen or motion-sensing 
devices in sight! 


External storage is essential, 
as SD cards offer limited space. 


The Raspberry Pi 3 can display 
1080p visuals over HDMI, so 
I've chosen a monitor that can 
handle this. 


I've chosen Raspbian for this 
experiment. Not only is it the 
premier Raspberry Pi OS; it 

is also well supported by the 
community, so | can easily get 
help if | need it. 
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SETTING UP 


built the basic hardware setup as described on 
i | the previous page. I downloaded and installed 
the latest version of Raspbian (you can do 
this via NOOBS, or follow our instructional video: 
Magpi.cc/2sj7IeN) and let it run through its automatic 
setup steps. With that, I was ready to start using the 
Raspberry Pi as a desktop computer. Let’s begin. 


Bian al: 


A very lightweight email 
client that comes bundled 
with Raspbian. You can use 
it like any other email client. 
If you’re using the Raspberry Pi for sysadmin or other Claws is fairly 
kinds of IT management, you’re not going to demand basic, but if all you really 
much from it. The trusty Terminal will be your best rsion of Chr need to do is read and reply 
friend, along with a quick peek at Google to check with Flash integration. to emails, you don’t need 
Stack Overflow. Rob thinks: Chrome is my much else. 

I’m treating my Raspberry Pi as an office desktop referred browser 1 we alsc 
computer. For writing magazine articles, this means t (as 
I’m about 95 percent covered by a word processor 
and an accompanying office suite, a web browser for 
general internet usage, and access to relevant chat 
protocols so I can coordinate with the rest of the team. 
These requirements will be the same for a lot of office 
workers. Let’s take a look at the tools you’re getting on 
Raspbian to help with this. 


Office suite: 


LibreOffice 


One of the most popular alternatives to Microsoft 
Office, LibreOffice includes a range of equivalent 
programs that are compatible with Microsoft 
Office files. Writer is your Word replacement, 
Sheets replaces Excel, Impress works with 
PowerPoint files, etc. 

I really like the LibreOffice apps, 
and Writer is a perfect substitute for Word 
and other word processors. This version of 
LibreOffice has been further optimised to look 
and run better on the Raspberry Pi as well, 
SO you won’t notice any performance issues. 


| 
' 
| 
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Here’s how I used the Chromium browser to handle multiple tasks 


e spend a lot of our lives online, accessing 
everything from email and search engines 
to news and social media, as well as web 

versions of popular software. Here are some of my 
top tips for making the most of your browser on Pi. 


EOE 


Gmail 


While I could access my Gmail through Claws Mail, 
I was interested in seeing whether | could get Gmail 
running in the browser. Surprisingly, Gmail takes up 
f alotof memory space while it runs. This increases as 
| you add different accounts. 
Luckily, Google has a solution: switching to 
: HTML mode while loading. Google claims that 
TOP TIP: this is to help with slow connections, but it also 
drastically cuts down the memory footprint. It 
looks as if you’re using Gmail in 2002, but it’s 
worth it. 


TUCNUTTCTO ETT T VOT Epes 
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Use SHIFT+ESC to 
- open the Chromium 
+ Doct Contacts task manager 


> @) 


a 
B 
a 
* 


> e: a= & a=" g, ~ 
3 &— eo € = a = 
e = Skype 
e== e>= = ae: 2: e ; . 
au . oT We use Skype for chatting at The MagPi, and while 
re = o- o- -- * ; 
& x a: az a: a: i tliere are Ctnen Chak pronocole tamimilgit pecasicn 
. : o- o= a: ax ps il to tap into (such as Hangouts), we can’t change 
= | - the way we work just for one person. I decided 
- Es = == to try web Skype (web.skype.com), and while it 
oe o e- o @: o wasn’t particularly kind to the memory 
@, =: e e~ resources, it did run happily 
S OBE 60 Ore o-- meee .- « Eppoe in the background while I got on : 
Fee Pe = sew i = = with other work. TOP TIP: 
# Mothcations Notifications I turned off some of the chat Use a different chat 
eo" 7 i features (including the giant client. Try out Pidgin 
— animated emoticons), and | for a very lightweight 


suggest that you do the same. way of staying 
in touch 


TweetDeck 


Mh canyon You may not use Twitter enough to need TweetDeck 
Oc: to manage all your accounts, but I was pleasantly 
=" . surprised at how well it worked. It does use a lot of 
x = = pi davintctel memory, but it runs just fine on the Pi, even when 


other programs are up and running. 
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This means that your Chromium browser 

is going to be running for most of the time 
while you’re using your Pi as a desktop, even if it’s in 
the background. As the Raspberry Pi offers limited 
resources compared with a modern desktop, you won’t 
be able to have 15 tabs up and running at once. Here’s 
my advice on how to maximise your browser efficiency. 


I spent the week working with four or five reasonably 


resource-intensive tabs open at a time, and that 


was probably stretching the abilities of the Pi. These 
included Skype web chat, Slack, TweetDeck, and 
Google Music (which Ill discuss over the page). 
Adding extra tabs starts to make Chromium a 
little wobbly, so I decided to close down tabs when 
they weren’t essential. Slack and TweetDeck were 


® OE BF OG rowrarico-nui_ 


' | Task Memory; CPU Network, Process ID 
| + @ Browser 55.460K 9.0 0 1042 
_ | *% GPU Process 13,688K 0.0 o 1158 
, |* & Tab Skype 1a fabK 0.0 o 1169 
>: | 8 Tabs TweetDeck T2.5904K 6.0 0 1145 
* Ed Tab: comms-team-chat | 94,492K 0.0 0 1184 


@ Tab. The Raspberry Pil 
_ | * @ Extension: uBlock Origin 
a i Background Page: Goog 


14,044K 
34,448K 0.0 
15,620K 0.0 


good choices; | could come back 
to them, but closing the tabs 
removed a distraction for a time, 
allowing me to focus on work. 
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One of my best friends during the week was the 
Chromium task manager: you can access it using 
SHIFT+ESC or open it from the Chromium menu. 
It displays a basic process list, giving memory and 
CPU usage for each tab and service. 

In this instance, the Raspberry Pi is limited more 
by memory than by CPU power. I found that tabs 
using about 100-150k of memory were at the upper 
limit of what the Pi could 
handle, and you really 
shouldn’t have too many 
of them running at the 
same time. I used this 
information when deciding 
which tabs to keep open. 


I don’t know about you, but I have a lot of the 
important notifications I need (work email, 
work chat, etc.) tied to my phone as well as to 
the desktop for when I’m out and about. It’s not 
unusual to get a ping about a work email on my 
phone and then check Gmail in the web browser 
eo) eleva! ie: 

While I completely understand if you’d rather 
keep work off your personal phone, notifications 
are easy to turn on or off, or even schedule on 
modern smartphones. I was happier to close 
non-urgent browser tabs when I knew that my 
phone would beep at me if something required 
my attention. 

Alternatively, while I chose to run a music 
streaming service through the browser on the 
Raspberry Pi, I could easily have done so via my 
phone instead, which would have freed up some 
Exitdiiemony: 


Which websites should you avoid? 


Twitter is a simple site, and I had very little trouble 
using it. As | mentioned before, TweetDeck is a great 
way to make the most of Twitter without causing the 
Pi to struggle. You can easily handle pictures, GIFs, 
and video through Chromium using TweetDeck. 


Facebook is very resource heavy and I struggled 

to use it unless it was the only tab running in 
Chromium. If you’re planning to use a Pi desktop 
purely for social media management or browsing, 
you won’t need as many tabs open, so you’ |l probably 
be fine. Otherwise, be careful with Facebook. 


Everyone’s favourite repository of cat videos, 
YouTube runs well on the Raspberry Pi via 
Chromium. Make sure you have some speakers or 
headphones plugged in. If you need to, right-click 
the volume button in the top right-hand corner of 
Raspbian and change it to Analog. 


Your mileage may vary, but other video sites or 
news sites that don’t use embedded YouTube 
videos don’t work as well as YouTube. Again, this 
will be dependent on the number of tabs you have 
open at any time. 


t is perfectly possible to use Raspbian or any 
other Linux distribution solely through the 
eraphical desktop. However, getting to grips 
with the command line or Terminal is essential to 
make sure your Raspbian experience is as smooth 
as possible. 
I found myself periodically having to enter the 
command line to troubleshoot issues I’d discovered sudo apt-get update 
during the experiment. Here’s how it works. 


Some essential commands 
you need to know 


Before installing software or updating your version 
of Raspbian, this command will let your installer know 
which software updates are currently available. Online 
versions can change regularly. 


The classic computer Also known as the sudo apt-get upgrade 

interface. There are terminal emulator, this 

no fancy graphics program allows you to After updating the software list, you can then 

here, just lines of run commands from upgrade any software that has a newer version online. 
text. You can use the inside the graphical This can take anywhere from five to 30 minutes, or 
computer by running desktop environment. even longer, depending on how long it has been since 
commands here. The best of both worlds! your last upgrade. 


sudo apt-get install [software | 


Access the Click on the Terminal 

command line using program in the toolbar. You can install software using the apt-get install 
CTRL+ALT*F1. Return The icon shows command, followed by the relevant package name. 
to the desktop with a window with a There is also an option to add and remove software 
CTRL+ALT*F7. black screen. using the graphical desktop. 


sudo reboot 

Use this to satelya@@Startthe Raspweny Pi, 
sudo shutdown -h now 

Use this to safely switch off the Raspberry Pi. 
startx 


From the command-line interface, you can enter 
the graphical desktop using this command. 


Got a problem? Pi running slow? Try these simple fixes 
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ike the task manager in Chromium, Raspbian 

has its own task manager known as top. 

You’ ll need to access it through the command 
line, by entering top. Once you’ve opened it, you can 
do some minor troubleshooting and ease the strain on 
the Raspberry Pi if it’s struggling. 


In my experience, applications that use a lot of 
memory are the ones that cause the most trouble for 
the Raspberry Pi. If something uses a lot of CPU power 
as well, that will also slow down the Pi. 

Using the columns displayed by top, you can 
determine which processes are taking up the most 
resources. Use the left and right arrow keys to change 
which column to sort the list by, so that when it 
updates you don’t lose track. 

Press k when you locate the resource-hungry 
Preetam, and enter picme@retOp the prggess 


0 S244 7544 OBB R 1.0 0.3 0:04.85 tcp 


Alternatively, you can press q to quit top and enter the 
following command: 


sudo kill [pid] 


If you need to stop a lot of processes with a similar 
name, you can also use: 


sudo killall [name] 
Not fixing your problem: The best place to look 


for solutions or ask questions is in the Raspberry Pi 
forums: raspberrypi.org/forums. 
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Four: 


GETTING DOWN 


few days into our experiment, I found myself 
A facing some admin tasks, so 1 was using more 
Office-style programs than on previous days. 
I needed access to collaborative documents from 
Google Docs and Sheets, and to WordPress for writing 
blog posts. Here’s what I needed to achieve, along ne 
with some of my solutions. z aKe)> 


set up Dropbox on 
a Raspberry Pi using 
Using online collaborative spreadsheets 
and documents 


the guide here: 
x magpi.cc/2c9NnPC 


As I discovered earlier in the week, juggling Chromium 
tabs is essential to keep the Raspberry Pi running 
well. Google Drive and Google Docs use large amounts 
of resources, so keep that in mind when working it we U ea 
with them. need to upload articles as well : 

I recommend trying to use one document at a time, production process. There are two main ways 
or to close as many other tabs as possible if you need | | 
to juggle more than one. If you keep this in mind, | x to Ra 
Docs and Sheets work well in the Chromium browser, the Dropbox web interface 
so you shouldn’t need to make any further changes to i rantages t 
eet them running. 


Dropbox 


How to read PDFs on the Raspberry Pi 


Opening a PDF on the Raspberry Pi is easy — there’s a 
dedicated PDF reader mstalled. Opening PDFs in the 
browser can cause problems, though. Chromium has 

a habit of trying to load PDFs into the browser without 
downloading them first. This is fine on a normal 
desktop computer, but it doesn’t always work on the Pi. 
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If you’re having trouble reading a PDF 
online, download it first and open it in 
the default program. If you need to copy 
text from it, you’ll need to open it in 
Chromium. Open a new tab, then drag 
and drop the downloaded PDF onto 
Chromium to load it. 
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Fes PROJECTS 


Use Google to search for lightweight alternatives 
to the software you normally use 


Things to keep in mind while using WordPress Experiment with several pieces of software until 
you find the one that works for you 


I didn’t have any big problems while writing The MagPi 
blog posts. The main thing that caused the Pi to slow 
down was adding images directly into the posts. I’d 
recommend uploading them to the Media library first, Above all, be patient 
before embedding them in a post. 


Be wary of fancy web interfaces; these will take 
up a lot of resources 


LJ | "| Gea - Lion J 7; = yeh! ae iy Ue | T cd thehine 


A lightweight alternative to Photoshop 


I don’t expect to do any serious image editing or 
touch-ups on a Raspberry Pi, but the ability to 
perform simple editing tasks (crop, rotate, resize) 
is important. Mirage is the software that allowed 
me to do this in Raspbian. It is very lightweight 
and works well. The display also includes a column 
showing all the images in a selected directory. 

It was quick and efficient for the simple tasks | 
needed, although for anything more complex you’ 11 
have to seek out a more powerful computer. 


wanted to relax on the evening Of the tinal Can Goku recruit Frieza for the Tournament of Power? 
: ; Find out next time on Dragon Ball Super... 
day, by watching some TV and playing some 
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games. While I’m performing this experiment, ae ct eee ee eee ee ere 
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viewing into fullscreen mode, which juddered a bit 


As we’ve discussed before, YouTube works just fine when it started but performed well over the next half 
on the Raspberry Pi with Raspbian and Chromium. hour or so as I switched between a selection of videos. 
I caught up with my YouTube subscriptions (handily I haven’t had much luck with other types of online 
ve placed in a Watch Later playlist) while sipping video this week. However, this task only used one tab 
peimeeraieear 2 tropical, rum—based concoction I'd deviseGie in my browser, so I thought I’d push the envelope a bit 
Disneywordsoon.. celebrate the end of the week. | darium@ly took my and see whether I could catch up on Dragon Ball Super 
 ecms 0 MEE ree via Crunchyroll. Unfortunately, instead of providing the 


ace = =©low-quality playback I had come to expect, the video 
a player just refused to load, leaving me unable to find out 
whether Goku had reached Super Saiyan Blue 2! 

I had similar problems with Netflix while trying to 
watch some of the new Unbreakable Kimmy Schmidt 
episodes. There are solutions to fix this issue 
(magpi.cc/2rDbtaE), but they’re not available by default. 


Leese of (ieegkie') Agro of ort of dnirmaiien nl 
i eet 


Hit and miss for online video, but at least 
= YouTube worked well 
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version of Minecraft, SPI EDITION, 
Minecraft Pi is great 
for making forts in mountains, and that’s before you start hacking it with 
your own mods! To run Minecraft Pi, open it from the desktop menu or type 
minecraft-pi ina Terminal window. 
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One cocktail down and with another to go, I decided to 
see how well the Raspberry Pi would handle streaming 
video over the network. The Pi has hardware decoding 
for HD video and I’ve run some playback with it before, 
so I was interested to see how it would all work. I have 
a file server on my network (powered by a Raspberry Pi, 
of course), so 1 connected to it and had a go. 

Omxplayer is bundled with Raspbian, and it provides 
one of the best ways to play video on the Pi. While 
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The settings 
file may look a little 
basic, but it gives 
you full control over 
the program 


You can quickly connect to a Samba/Windows 
shared folder by opening File Explorer (the 
folder icon) and typing into the address bar 
smb: // followed by the IP address of the 
computer, or its name on the network: 


= smb: //mediaserver 

it is a Terminal app, a GUI that will automatically 

play your videos is available (via the kweb suite: 

magpi.cc/2sTExQo). | did need to change the audio ee eee ae 


output settings: open the GUI via Menu > Sound & 
idee ,eleWwon Edit Settings@amedimaen click ommente 
analogaudio button at the top of the settings page. 

The video playback might not line up with the 
interface, but the HD video plays just fine, using the space 
bar to pause and play. | like to watch anime and tokusatsu 
shows, which usually come encoded in 10-bit colour. 
While Omxplayer will play them, expect some glitches 
as the Pi doesn’t support 10-bit hardware decoding. 


A very similar experience to using a video player 
on a normal desktop, thanks to Omxplayer 


Easily view your files over the network using Samba - 


it can be used for more than just streaming media! 


A fun little game from ~ J 
Vlambeer that is available 
as a Gamemaker game 
for the Raspberry Pi. 

Get it here: 


magpi.cc/2s8tdhK 
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| always enjoy having - an | 
a quick look at the Bey “> ae] eae. 


Scratch website to see 

what fun little games natant Pg 

| can find for the Pi: im ise a, P= 
scratch.mit.edu oo : 


oing into this experiment, I wasn’t sure what 
to expect. I’ve been using the various models 
of Raspberry Pi for more than five years prioritise my tasks and software to guarantee the 
now, in all manner of ways, but never as a full-on 
desktop replacement. I knew the Pi was capable of the 


best performance. I also had to remove the power a 
individual tasks I’d need to do, but I was wary of trying 
to get them all running together. 


As I’ve explained, juggling all my tasks was a little 
taxing on the Raspberry Pi, and I had to learn to 


few times, so I learned to save anything important to 
external sff@neesinveadse’the SD card commie 


I learned two main lessons from the week with Pi... 


Tieraspeecrry Pi, liketiincomptrervear only do 
soumueh at once@iher wicca Ditmmere limited than 
a modern laptop or desktop computer, so you can’t 
expect it to immediately load all the elements of 
a webpage or instantly open the document you’re 
working on. 


If it seems to hang, give it some time to sort itself 


out before you start killing programs or consider 
pulling the plug. 
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Like all relationships, using the Raspberry Pi as 

a desktop computer involves some compromise. 
Sure, I’d love to have all the things I need to work on 
running at once, but the Pi can’t quite handle them. 
Instead, I moved my music listening to my phone, 

I made sure that windows and software were closed 


when they weren’t needed, and I used the HTML 
Gmail interface for my email. 


Vi. 
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All this resulted in increased efficiency during my 


work day in some ways, but other tasks took longer, 
so it balanced out overall. 
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GETTING YOUR [#esrenye: 
HARDWARE 


Want to try out a Raspberry Pi desktop for yourself? 


Pick up the kit you need online £90/$115 to 
| £235/$300 


You can build a Pi desktop yourself, or try one 
oi these Pi PCs instead 


Raspberry Pl 


Retailers to 


pi-top.com 


Websites that specialise in supplying Raspberry 


Pis offer some great deals on kits, along with The pi-top is one of the first major Raspberry Pi 
the accessories you’ ll need. Here are some full-computer kits, available as a pi-top laptop, 
of our favourites. or a pi-topCEED desktop. They're designed for 


educational purposes rather than desktop use, 

a . but they're very easy to convert once you've got 
Pimoroni everything up and running. The pi-topCEED is the 
shop.pimoroni.com cheaper model, and all you need to provide are the 
Pimoroni is a great place to find mouse, keyboard, and external hard drive. 


cool Raspberry Pi kits, along with >) Jf C if QC rf 
some great project ideas and b | £112/$110 


accessories. They're famous for 
their funky Pi cases made from 
layers of laser-cut acrylic. 


The Pi Hut 


thepihut.com 
The Pi Hut always has great Little 
supplies for your Raspberry Pi 


www. ThePiHut.com 


projects, as well as everything 


you'll need for a Pi desktop. WD Dj D rive 
Compute Centre 
Adafruit magpi.cc/2s8NbZr 


adafruit.com We reviewed this kit in issue 56, and we think it's 
Looking for Raspberry Pi gear great. It is part of the WD PiDrive series, so it comes 
in the USA? Adafruit is one of | Ne with a case and a hard drive setup optimised for use 
the best sites, and has its own =| dafr Li iC with the Raspberry Pi. You won't need an external 
awesome range of components NN | ATS 1T hard drive for this setup, and it even comes witha 

to use with your Pi. mouse and keyboard - all you need is a monitor! 
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SUBSCRIBE TODAY AND RECEIVE A 


Subscribe in print for 12 
months today and receive: 


A free Pi Zero W (the latest model) 


Free Pi Zero W case with three covers 
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Free Camera Module connector 
Free USB and HDMI converter cables 


Other benefits: 


Save up to 25% on the price 


= Free delivery to your door 
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Quick 
Facts 


> The differential 
GPS system 
is accurate 
to 20 cm 


» The robot uses 
three Python 
programs 


> €6 IKEA 
lunch boxes 
protect the 
base stations 


> Big Rob has 
a 12 V 30 Ah 
battery 


» See videos 


gah Me 


Guide robots with incredible accuracy using this differential GPS system 


hile building a rugged 

robot, named Big Rob, for 

outdoor use, Ingmar Stapel 
wanted to create a system for 
precise navigation. Disappointed 
with the accuracy of the standard 
USB GPS modules used on his 
previous robots, he decided to 
build a navigation system based 
on differential GPS. 

Differential GPS uses the RTK 
(Real Time Kinematic) method for 
carrier—based ranging between 
a base station and the robot. 

Data sent from the base station 


enables the robot to correct the 
inaccuracies in its own GPS signal, 
mainly caused by atmospheric 
effects, in order to calculate its 
precise position. This technique 
produces an accuracy of 20 cm, 
compared with 4-5 m for 
Standard GPS. 

Both units are equipped witha 
RasPiGNSS Aldebaran module from 
drfasching.com: “It is the only 
one I know which is especially built 
for the Raspberry Pi,” explains 
Ingmar. They are also fitted with 
a Tallysman GNSS antenna that 


of Big Rob at 
magpi.cc/ 
2rPfEnz 
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can receive not just GPS signals, 
but also those from the Russian 
GLONASS system, as well as SBAS 
systems such as Europe’s EGNOS. 


XBee or WiFi? 


To minimise GPS inaccuracies, 
Ingmar is using the RTKLIB Python 
library (rtklib.com) to perform 

the RTK calculations. “The most 
complex part of this project was to 
configure the RTKLIB library and 
to set up the XBee communication 
between the base station and 

the robot.” The main advantage 

to using XBee Pro rather than 
standard WiF'1 is its superior 

range of up to 1.6 km. However, 
Ingmar has also tested the system 
using WiFi, which offers a higher 
bandwidth. Both versions of the 
RTKRCV program are described on 
his blog. 


The base station sends its own 
position to the robot to eliminate 
GPS inaccuracies caused by 
atmospheric effects 


The two units are in constant 
communication via XBee modules 
or standard WiFi 


The robot calculates its precise 
position using differential 

GPS, and can direct itself to 
various waypoints 
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>STEP-01 

GPS modules 

Both the robot and the base station feature 
a Raspberry Pi equipped with a RasPIGNSS 
Aldebaran module and Tallysman antenna 

to receive satellite signals. 


Robotic navigation 

So, how does it all work in 
practice? Ingmar admits that 

it can take a while to obtain 

a GPS fix, depending on the 
Surroundings and weather. 

“Tf use the setup in open country 
with no clouds, the calculation 
of a fix position takes between 
10 and 15 minutes. If I use it in 
the yard with high buildings 
around the base station and 
robot, it could take up to an 
hour to calculate only a floating 
GPS position.” 


Once it obtains a fix, the robot 
moves continuously from one 
waypoint to the next, checking its 
orientation with the Sense HAT 
magnetometer: “If a deviation of 
five degrees is detected to the next 
waypoint, the Python program 
corrects the speed of the DC 
motors to face the waypoint. Only 
if the GPS signal gets lost will the 
robot stop and wait for the next 
calculated fix position.” Waypoints 
can be entered in a Terminal 
window or imported via a Google 
Earth KML file. 


>STEP-02 

XBee communication 

XBee Pro modules, connected to Raspberry 
Pis via XBee Explorer boards, are used for 
long-range data communication between 
the robot and base station units. 
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Big Rob 

Ingmar has equipped his Big Rob robot 
with the differential GPS system, along with 
a Sense HAT at the rear to aid orientation 
when navigating between waypoints. 


Ingmar has a few ideas for 
putting his differential GPS system 
to practical use. “TI will mount the 
metal detector (as used on his 
Discoverer robot, featured in The 
MagPi #48) on the front of Big Rob, 
and together with the differential 
GPS setup, the robot will be able 
to search very precisely for metal 
in the ground. The next idea is to 
mount, for example, a lawnmower 
on the front or to build a fertilizer 
spreader. The differential GPS 
setup is a key feature for many 
ideas and setups.” 


.eft The path of a test drive, showing the 
precision of the system with a floating 
solution from the RTK calculation 


low An early version of Big Rob showing 
| the GPS system components, along with 
| anilluminated Sense HAT at the rear 
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Projects 


TELE 


How a Raspberry Pi kit helps people to live the life of a complete stranger 


> The Telez kit 
was used in 
five different 
countries 


> The idea came 
from the movie 
Being John 
Malkovich 


> 36 million 
people were 
made aware of 
the project 


>» Acustom iOS 
app was used 
to control the 
data stream 


> The equipment 
was in use for 
more than two 
months 
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e have all imagined what 

it would be like to be 

somebody else, even if just 
for a short time. 

Tele2 is one of the more 
intriguing projects we’ve come 
across. It was a custom Raspberry 
Pi electronics kit worn by various 
interesting people from around the 
world. Each person wore a GoPro 
Hero 5 and R@de Video Microphone 
to capture a first-person view of 


what they were seeing and hearing. 


The Teradek VidiU enables the kit 
to stream live video to the web 
via the Tele2 modem 


More intriguingly, the 
system collected data on each 
personality’s heart rate and 
sweat level. 

All of this data was used to 
measure the emotional state of 
the person, which was relayed to 
the viewers using visual effects 
layered on top of the audio and 
video. Brain sensor (EEG) data 
was translated into warmer or 
cooler video filters to represent the 
person’s emotions. 


The Galvanic Skin Response 
Sensor, Polar Bluetooth HR 
monitor, and Muse headband 
all gather data on the emotional 
state of the wearer 


WICH 


We caught up with Alvin Groen, 
the director and designer of the 
Tele2 project, who dreamt of 
building a piece of equipment that 
“changes our perspective.” 

The Tele? project is named after 
the Swedish telecom company that 
sponsored the project. “They were 
launching a new 100GB data plan 
and wanted a project that required 
high data bandwidth,” recalls 
Alvin. With funding underway, the 
Tele2 project was born. 


An e-Health v2.0 board is mounted 
above a Raspberry Pi 3. The Pi 
collects the video and audio data, as 
well as the health measurements 
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Above The kit recorded everything a 
person saw and heard while measuring 
their mood levels 


“In Sweden, a lot of discussion 
around connectivity tends to be 
negative,” says Alvin, “especially 
when it comes to controlling our 
exposure to media.” 

Alvin wanted to alter the outlook 
people had on other lives. “Each 
person was chosen because they 
have a big following online, or 
they have an interesting life,” 
explains Alvin. They included 
Simone Giertz, a robot maker from 
Stockholm, Joel Kinnaman, an 


processed all the video, audio, and 
sensor data. 

Camera footage went to a colour 
erading box in the backpack. This 
was “fine-tuned for each location”, 
and the video and audio was 
streamed live via a Teradek VidiU 
wireless HDMI video encoder. 

The built-in wireless features of 
the Raspberry Pi 3 made it a good 


They were launching anew 1O0GB 
data plan and wanted a project 
that required high data bandwidth 


actor from Vancouver (and star 
of the RoboCop reboot), and Noor 
Daoud, a female drift racer from 
Dubai. An impressive collection 
of folk. 

Each of the personalities was 
hooked up to the Tele2 equipment. 
The team broadcasted nine live 
streams in five countries during 
a two-month world tour. “We 
measured the personalities’ 
heart rate, emotions, and sweat 
level,” using a Skin Response 
Sensor and Muse headband 
(choosemuse.com). Then, using 
WebGL and web audio technology, 
they translated the data live into 
audiovisual effects. 

The team built a custom 
backpack using a 3D printer 
for each personality. The rig 
included a Raspberry Pi hooked 
up to an e-Health v2.0 board 
(magpi.cc/2qnMyry). The 
Raspberry Pi collected and 
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fit for the project. “The built— 

in Bluetooth chipset, wireless 
networking, and the fact that you 
can use a pretty standard flavour 
of Linux right out of the box 
made it very easy to work with,” 
says Alvin. 

“Since all the other equipment 
was rather bulky, size wasn’t 
an issue either,” he adds. “The 
toughest challenge was trying to 
figure out if we could get the Muse 
headband to communicate directly 
with the Raspberry Pi, since the 
official Muse SDK wasn’t released 
for the ARM architecture.” 

The project was a huge success, 
with hundreds of thousands of 
people tuning in to see what it’s 
like to be somebody else. Viewers 
could click on cheers and give 
feedback to the wearers. Overall, 
Tele2 was a very interesting 
combination of health sensors 
and live video streaming. 
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The cylinder is divided 
into sections for storage 
and dispensing 


A stepper motor rotates 
the inner cylinder to 
dispense the treats 


The Camera Module is 
used to detect motion 
and capture photos 
and video of the dog 


With motion detection and video capture, is this the ultimate dog treat dispenser: 


> Build details 
are on 
Instructables 
magpi.cc/ 
2sTf5qU 


>» There are four 


ways to trigger 
the device 


> It can dispense 
treats of 
different sizes 


» Eric has added 
a ball launcher 


» He intends 
to extend 
it further 
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hile pondering what to 

get Shirin, his fiancée, for 

her birthday, Eric Page 
realised how much she misses her 
dog Pickles while she’s at work. 
He decided to build a device to 
allow her to serve treats to Pickles 
remotely. “She uses it almost 
every day! Usually once a day when 
she is at her office. When she’s 
travelling, she probably sends 
him three or four treats every 
day. I think it helps her feel closer 
to home.” 

There are four ways to trigger 
the Pi-powered device: email, 
MOTT, IFTTT, or Alexa. It then 
plays a sample of Shirin’s voice, 
dispenses some dog treats, and 
checks for motion using OpenCV 


analysis of the view from a 
Raspberry Pi Camera Module. If 
motion is detected, it captures a 
photo and video of Pickles, which 
are sent to Shirin in an email with 
a randomised cute comment. If 
no motion is detected, it sends 
an ‘I’m not home but will enjoy 
the treats later’ message, along 
with a couple of photos of Pickles 
playing outside. 

Eric Says motion detection was 
an important addition. “I didn’t 
want to send my girlfriend a video 
of a floor full of treats. Even if 
Pickles was home, if he walked 
over to the treats more quickly or 
slowly than expected, the video 
would be blank for a period of 
time. So I built a motion detection 


system using really good code 
from Adrian at PyImageSearch. 
This ensures that the video always 
Starts with Pickles entering the 
area, and Shirin can see him 
trotting up with excitement.” 

Far from being a seasoned maker, 
Eric reveals “this was my first 
attempt at anything DIY in probably 
25-plus years since junior high, 
so it took some trial and error.” 
After starting the project with an 
Arduino, he soon realised that it 
lacked the processing power and 
storage required for video and other 
complexities. “After I switched 
to the Pi, it took 30-45 days to get 
to aversion that would reliably 
deliver treats via email. After 
that, | periodically tinkered with 
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Eric reckons 
Pickles thinks 

of the device as 
“some sort of 
God of Treats. 
Sometimes, we'll 
see him just 
sitting in front of 
it, looking up at 
it with a mixture 
of awe and 
delight” 


Below The 
ingredients for 
the perfect dog 
treat dispenser 
include a Pi, 
Camera Module 
laser-cut tubes 
and stand, and 
a stepper motor 


it for four to five months, adding 
additional delivery mechanisms 
and improving the reliability of the 
code, e.g. reconnecting everything 
if the WiFi went down.” 

Eric says the most difficult part 
of the project was getting the 


opening to a smaller section that 
holds and dispenses one serving.” 
Following the success of the 
Enea, GUIS SINGS. Ike Nes Eooemialec. 
the project by building a ball 
launcher using RFID-tagged balls, 
which he’s trained Pickles to 


Now Pickles can get his own 
treats by putting those balls 
in the receptacle. He loves it 


device to deliver a small number 
of treats (not zero or too many) by 
eravity from its plastic cylinder, 
when rotated by a stepper motor. 
“The design went through several 
iterations before | hit on the 
concept of a cylinder with a central 
storage area, with an adjustable 
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retrieve and place in a receptacle 
equipped with an RFID reader. 
“Now Pickles can get his own 
treats by putting those balls in 
the receptacle. He loves it. Now, 
he even sits by the ball launcher 
making funny noises — his way of 
saying ‘Dad, launch a ball!’.” 
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OCKE I- TINY 


Possibly the world’s smallest Pi-based gaming device 


> Tiny Pi took 
two months 
to create 


> It runs for 3.5 
hours on a 1000 
mAh battery 


> Peter is 
considering 
selling his 
custom PCBs... 


> ..or putting 


eter Barker was inspired 

to start making miniature 

gaming devices following 
the release of the Pi Zero, and seeing 
other makers cramming it inside 
an old Game Boy. “After ordering 
all the parts, I initially wanted to do 
the same, but couldn’t bear to take 
a working Game Boy apart.” 

Instead, he created his first 

standalone Pi Zero-based gaming 
device using a cheap 2.2 inch SPI 


screen flanked by two stripboard 
button arrays. “Things progressed 
from there, really,” recalls Peter. 
“| didn’t like how big the circuit 
board was for the screen, and 
realised that there weren’t all 
that many bits to it, sol started 
designing my own.” 

This resulted in his diminutive 
Game Boy Zero device featuring 
a 2.2 inch display on a custom 
PCB, “which was pretty much as 


together a 

Tiny Pi kit 
» He'd like 

to create a 


Pi pocket 
computer 


A three-way switch can be 
mapped to extra functions 


Tiny Pi's custom-designed 
PCB is just 0.8 mm thick 


The 1.44 inch TFT screen's 
128 x 128 resolution is a perfect 
match for Pico-8 games 
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small as I thought I could go.” 
However, Peter then found a 
smaller, 1.44 inch TFT screen that 
perfectly matched the 128 x 128 
resolution of the Pico-8 fantasy 
games console (magpi.cc/2rCswv1) 
that he’d stumbled across after 
looking at the PocketCHIP 
handheld computer. “It took me 
back to the good old days of the 
[Sinclair] Spectrum, where the 
system was small enough that 
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kids in their bedrooms could make 
brilliant games. I tried it on my 
GBZ project and it was good fun to 
have a portable system that could 
play all these games, almost like 
having a part of my childhood 

in my pocket.” 

Tie PiCGte TSM 21 
(magpi.cc/2sdhmf8) took him 
two months to put together. 

“The biggest hold up was getting 
my hands on some screens. There 


by two piezo transducers situated 
behind the screen. 

As well as Pico-8 software, 
Peter has programmed the Tiny Pi 
to run classic console games via 
the RetroPie emulation system. 
“You are restricted on the games 
you can play. The 128 x 128 
resolution makes things like SNES 
or Mega Drive games hard to see, 
although the Pi is actually capable 
of playing them.” 


As well as Pico-8 software, Peter 
has programmed the Tiny P1 to 
run classic console games 


are many suppliers who sell them 
attached to a PCB, but I didn’t 
want that extra bulk.” Instead, 

he designed his own super-skinny 
PCB, a mere 0.8 mm thick, which 
is mounted directly to the rear 

of a Pi Zero W. 

On the front of the PCB are a five- 
way joystick (with push-in function) 
and two push buttons. There’s also a 
three-way navigation switch at the 
top, which can be mapped to extra 
functions. The device is powered 
by a slimline LiPo battery, strapped 
to the Pi Zero along with a TP4056 
charger. Stereo sound is supplied 
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The original version of the Tiny 
Pi was ‘naked’, but Peter has since 
clothed it in a 3D-printed custom 
case. Designed using OnShape 
(onshape.com), he’s made it as 
Slimline as possible, to match 
the rest of the project. “It needs 
a spot of refinement, but the 
main change I would like to make 
would be to the software side of 
things. My real goal is to have it 
like a Game Boy, where it starts up 
quickly, you can play a few games, 
then just switch it off, no worries 
about shutting down and waiting 
for it to finish things.” 


You can get an idea of just how tiny the Tiny Pi 
is when it's placed next to a Nintendo Game Boy 
With RetroPie installed, the Tiny Pi can emulate 
classic games machines such as the Sega Game Gear 
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Practise coding for the Sense HAT hardware using the Sense HAT 
emulator built into Raspbian 


humidity py 


sense emu SenseHat 
sense = SenseHat() 


green 
white 


| Pena omy Sensehat 


fence = Lencebati } 


green = (0,255.0) humidity sense. humidity 


Shite = (235, 295,235) 


TLLSLty = Sanee PARTY 


humidity value = 64 * humidity / 10@ 
pinels = tgrean 10 a < imadaty valve field: Cer her tage) | pixels = [green i < humidity_value 
white i range(64) | 
sense.set pixels(pixels) 
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Use Git version control software to work on your own code 
and contribute to open-source projects. By Marc Scott 


mkdir snitch-sniffer 
cd snitch-sniffer/ 
fk 3 nano README 
Ple@raspperryp.1: ls 
README .md 
pi@raspberryp1: | Fit init 
Initialized empty Git repository in /home/pi/snitch-sniffer/ 
.21t/ 
pi@raspberrypl: 
README .md 
pi@raspberryp1: 
gescription 
contig HEAD 


pi@raspberrypi: 
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’ OPE {DS Ee cresptirye: - ian = TL ah | wa}izes 


Modified 


t gis 415s 
_— 2 ee 


im) (3 > 
hs 


aay 


& C3 |Esoi@respbenypi:~/sn. 


$ TL @) | exjises 
pi@raspoeryp: ~/snich-snitfer 
: git commit -am ‘finish find func J 
tion’ 
[master ble548e] finish find function 
1 file changed, 1 insertion(+) 
pi@raspberryp1: | sni iW 


git 
PRE i me Dt arwat 1 
PERS] add REALE. mci 


5 — i % 
14+} 


This commits all the changes you have made in the 
directory to the Git repo, and adds a message saying 


what you did. The message can be anything really, but 


it’s best to keep it fairly short yet descriptive of what 
you changed. 


Time travel 


Now that you have set up your repo, it’s time to get on 


with the project. Create two new files and store them in 


your snitch-sniffer directory: 


touch snitch-sniffer.py quidditch-rules. json 


Typing Is reveals those files. 
README.md quidditch-rules.json snitch- 
sniffer. py 


The new files need to be added to the Git repo and 
then committed. 


git add --all 


git commit -am ‘add json rules and python 
program' 


Carry on working on your code (enter nano 
snitch-sniffer.py and add some dummy code). 
Every time you make a change to the file, perform 
a new commit. 


git commit -am ‘finish find function' 


Now imagine that you’ve made a horrible 
mistake. You’ve been working for a while, 
and you’ve deleted your find_snitch() function, 
and then performed a commit. With Git, it’s easy 
to go back in time and restore an earlier version 
of any of your files. Let’s first look at the commit 
history of the file. 


git log snitch-sniffer.py 
This produces something like this: 

commit 
12c4c693e95438ceadcf3f4fb39c83celade712Ff 
Author: Harry Potter <h.potter@hogwarts.prog> 
Date: Fri Mar 3 20:27:17 2017 +0000 

delete find function 
commit 
5£d772a292c019a7cf3012b1156685280d4a7d2d 
Author: Harry Potter <h.potter@hogwarts.prog> 


Date: Fri Mar 3 20:24:52 2017 +0000 


finish find function 
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commit &8d1614¢c7251 fbd16626acaS3accO8d6sfc79lblaa 


eee eee nd 
a # cadu/1/4baZab 


commit 4e8b/e/Tée/ddcold7éfozfcsdel 


=~ 3 PA -a- fA = 
commit f55/ce90ca; 


commit 
127545c19794b5 fe869dd22d0cf57bf8820c5794 
Author: Harry Potter <h.potter@hogwarts.prog> 
Date: Fri Mar 3 20:20:18 2017 +0000 


add json rules and python program 


You can see that the last commit (the one at the 
top) was where the function was deleted. Luckily, 
the commit message has made it easy to see what was 
done, which is why commit messages are important. 
However, typing: 


git log -p snitch-sniffer.py 


...would have shown the changed contents of the 

file if the commit message wasn’t clear enough. 
You can now get back the version of the file 

from the previous commit. The long string of 

characters after the word ‘commit’ is called a 

hash, and is used by Git to keep track of files. In 

this case, the commit that needs to be restored is 

5£d772a292c019a7cf3012b1156685280d4a7d2d. 

Typing the following will get the file back to the way 

it was: 


git checkout 
5£d772a292c019a7cf3012b1156685280d4a7d2d 
snitch-sniffer. py 


The file will be restored, and you can now commit 
this change. 


git commit -am ‘restore find function' 


Making major changes 
Imagine you’re talking to someone about your 
amazing project, and they have a cool idea for some 


You can always check 
the current status of 
your repo 


changes you could make to improve it. They suggest 
using lidar rather than ultrasonic sensors. The 
changes are quite large, though, and you’re worried 
that if you make them, you might break the project. 
You could make a copy of the directory and start 
working on this copy, but to keep using Git, you’d 
have to make an entirely new repo. This could all 
get quite confusing. Luckily, Git has a feature called 
branches. Using a branch allows you to make copies 
without losing or altering your original work. 


First, you can have a look at your repo’s current status. 


git status 
This should show something like this: 


On branch master 
nothing to commit, working directory clean 


Now you can make a new branch in the repo, which 
lets you work on your amazing new adaptation. 


git checkout -b lidar-version 
Now git status will show you something like this: 
On branch lidar-version 


nothing to commit, working directory clean 


This tells you that you are on the lidar-version branch. 


To view all the branches in your repo, you can type git 
branch, which will show something like this: 


* Jidar-version 
master 


You can now work on the lidar-version branch without 
altering your master branch. If you try out the new 
approach and find it doesn’t work, you can simply delete 
the branch using git branch -D lidar-version. 
However, if it all works well, you can merge the 
branch back into your master branch. First, you’ll 
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need to make sure all your changes are committed and 
then switch back to the master branch. 


git checkout master 


Then you can merge the version into the master 
branch: 


git merge lidar-version 


Warning: you can cause problems with a merge if 
you're working on two branches at the same time, 
as Git won’t know which changes are the ones you 
want to keep. For this reason, it’s best to work on one 
branch at a time. 


Setting up a Git service 

Now that you know how to do the basics in Git, it is 
time to learn how to use it to its full potential: sharing 
your work and collaborating with others. 

There are lots of services that will host your Git repo 
for you, free of charge. GitLab is one such service, and 
BitBucket is another. In this resource, you are going 
to be using GitHub (github.com), which is one of the 
more popular services. 

The first thing to do is to register for an account on 
GitHub: just choose the free plan. Now that you have 
an account, you can create a snitch-sniffer repo on 
GitHub. Click the New Repository button to the right 
of Your Repositories. Give the repo a name (enter 
snitch-sniffer in the Repository Name field, anda 
short description, such as ‘3D tracking of objects in 
space’ and click Create Repository). This will bring 
up a page of instructions. As you already have a repo 
ready to push to GitHub, all you need to do is make 
sure you are in your project directory in a Terminal 
window, and type: 


git remote add origin https://github.com/ 
harrypotter/scratch-sniffer. git 


...and then: 


Merging puts the changes you have made into your master branch 


raspberrypi.org/magpi 


Créale a new repository 


ipa) oes a ee ee es See 


Gare 
Beentarcmn: | 


Seat epeetor uen ed et pele emi Gerd ren! the abet epmeeeiric at 
DCA 


Peep 2 po Lena 


#| | Puna 
Ae See SE, Re eS SP Le ee 


PS erence 


tes ee ee cs ee ed ee ee ee 


ee 


qe ey oe eee ee de Ee ee 
cack WBA) 


eicesssos Bieta = amet eee Meme = | 


Oe ee eta ee ee 


The snitch-sniffer 
repo, showing 
branches, commits, 
and other information 


OQ lucyhattenveyrecs  \DL 
< g i. SeUre — agthub com poyiu mee nteaio 


0) hicyhattersiay ! poratch-eniffer a= Oo bate Oo Rk oO 
Co Cate ei | O) ul Pegs OO tress oO Tat 0 beatings naights = 


2d tebang of obenti in epee 
Sok (ope 


Be pewnks 2 0 eer 1 corto 


Eranc*: i!é-,7, = Aiea pull raquaat (Crgant ori Phe Upc Fes =| Plred ie [tone or ewaiaad | 
Bi lucyhariersley sire barren haben Garner Hiuedeal v dav age 
5 Ee md id FE ed 7? aa c 
OG) gules jai ha fold And py pre i Says age 
B oth ott py Peed bila Acts 


2 ye age 


The Golden Snitch Sniffer. 


Thee if a Groeect Chet Wee Muiicle longerange WEOn BENeore fo Gnd and neck an oblect fing in fnres- 
STEHIONa dpOce. M Ghplayd (nd CODHECTS Coordinated, speed, and tractor inrcugh 4 VAL maaceet 


SOU Fatt tem Det a) een ati ety bata 4 Sibel fae AP Wel Be A iene 


Giiheae com heephallbereley! oral choo ler eanches 


Tutorial 


Raspberry Pi 
Zero W with 
case and 
GPIO header 


Ultimate GPS 
breakout 
magpi.cc/ 
2qLDUpB 


Pimoroni Scroll 
pHAT 
magpi.cc/ 
2qMVMks 


40-pin stacking 
header for the 
Scroll pHAT 


USB to micro 
USB cable 
for power 


12 V USB power 
adapter suitable 
for a car 


SPEED UP GPS 
ACQUISITION 


Installing 
the optional 
battery on the 


GPS board will 
significantly 
speed up 
satellite 
acquisition 
when starting 
the system 
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SAILING P|! 


Track and map your Sailing adventure, wherever you go 


y weekly sailing crew asked for a way to 
visualise where we had been, and for a live 
display of the true speed over ground to see 
whether we were fighting tides. This project delivers 
both, without relying on internet connections or cell 
phone data. Add a battery and it would also be useful 
for car rallies or cyclists. All you need is a Raspberry 
Pi Zero W with some additional hardware, Python, 
and Mathematica! 


Assembly 
Solder the dual male header to the Raspberry Pi 
Zero W, and solder the stacking header to the Scroll 
pHAT. Cut off the header wires except for pins 4, 6, 8, 
and 10 (see magpi.cc/2sApUOQ). Double-check the 
pin numbering before you do this! Bend these four 
pins through 90 degrees so that they point outwards. 
Take four wires of different colours, about 10 cm 
long, and solder them into the GPS breakout Vin, GND, 
TX, and RX connectors, bringing the wires in from the 
top of the board. Next, solder the Vin wire to pin 4 of 
the GPIO, GND wire to pin 6, RX wire to pin 8, and TX 
wire to pin 10. There should be no crossover wires. 


Software setup 
Boot up your Raspberry Pi Zero without the 
GPS attached. Go to Preferences > Raspberry Pi 
Configuration. In the Interfaces tab, be sure to enable 
SSH, Serial, and I?C. In the System tab, you will also 
ensure the Boot option is ‘To CLI’ (command line 
interface). Next, set up the wireless and reboot. 

Now load some special software for the Scroll pHAT 
and the GPS: 


sudo apt-get install python-scrollphat gpsd 
gpsd-clients python-gps 


The GPS uses the TX/RX pins that are the console 
defaults, so you need to make some modifications to 
the system: 
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sudo nano /boot/cmdline.txt 


Remove the console=serial®@, 1152@@ portion of 
the line. Then save the file and exit the editor. 


sudo systemctl stop serial-getty@AMAQ@.service 
sudo systemctl disable serial-getty@AMAO. 
service 

sudo halt 


When the system stops, remove the power and 
install the scroll pHAT with the GPS breakout. Power 
the system up. The Fix light on the GPS board will 
blink once every second with no satellite fix, and every 
15 seconds with a fix. If you don’t have a fix, move the 
system to a window with a good view of the southern 
sky (northern sky in the southern hemisphere) where 
the antenna can see the satellites. 

While you are acquiring a lock, we need to disable 
the standard gpsd socket. In a Terminal window, type: 


sudo systemctl stop gpsd.socket 
sudo systemctl disable gpsd.socket 


Program 

Download the Python program gpsd-boat.py 

and Mathematica notebook LatLonPlot.nb from 
magpi.cc/2qN6BmG. The system will not have a live 
internet connection while you are sailing, and so it 
will not know the date straight away. As a result, the 
program waits for the GPS to get a fix and uses the 
UTC date information to generate file names with the 
current sailing date. Automate everything so that the 
program Starts at boot time: 


sudo nano /etc/rc.local 


Add the following two lines to the file just before 
the exit @ line: 


gpsd /dev/ttyS® -F /var/run/gpsd.socket 
python /home/pi/gpsd-boat.py > /home/pi/ 
gpsd-boat.log 2> /home/pi/gpsd-boat.err & 


Then save and exit. The last line will start the 
Python program as a background job, redirect output 
to a log file, and redirect any error messages to an 
error file for later debugging. 


We are sailing 

Now go sailing, or perhaps driving. A12 V automotive 
USB plug works in a car or in the boat, in one of the 
many 12 V outlets. Above deck these are likely to be 
corroded, so be prepared to clean the contacts (Scotch 
Brite scouring pads work well), and keep the Raspberry 
Pi and GPS in a plastic bag to ward off water. Power 
everything up and go for a sail. When you’ve finished 
sailing, unplug the system and take it home. 
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When you get home and have internet access again, 
connect the Raspberry Pi to a monitor and keyboard. 
The CSV output file is designed to be easily read with 
Mathematica. However, because we crashed the Pi to 
power it off on the boat, you will need to edit the file 
with nano and remove the last line or two, which will 
contain some garbage. If the application crashed and 
restarted at any point, there will be extra headers you 
should search for and delete. These files were written 
as root, so, where 2017-05-04 is replaced by your 
activity date: 


sudo nano 2017-@5-04-latlon.csv 


Remove the last few lines and any errant blank lines 
or additional headers. Then save the file and exit. 

Start Mathematica and use the LatLonPlot.nb 
notebook you downloaded to visualise your sail, but 
replace the date with the date identifier for your file. 
The first line of the file imports the data from the 
comma-delimited file and loads the header and data 
separately. The output of this command should be 
a partial list of all the latitude and longitude pairs. 
The second line converts the latitude-longitude 
data into a GeoPosition set of variables, and then 
a GeoPath construct for plotting. The output of this 
should be a small graph of the path taken, but with 
no map. The third line places the GeoPath on an 
automatically sized map and places the output in the 
file image.jpeg. PlotStyle controls the colour and 
thickness of the sailing path plot. 

Hit SHIFT+ENTER to force an evaluation and wait 
a while (the header will show running), particularly 
if it was a long sail. It takes quite some time for 


MOUNTING 
THE UNIT 


The final 
product is held 


in place with 
Velcro strips 
on the back 

of the Pi and 


Mathematica to load the map data over the internet, 
so be patient. When the calculation is complete, open 
the image.jpeg file to have a look. 


on the boat 
console 


July 2017 MagPi | 49 


Tutorial 


BLUE DOT 


Android phone 
or tablet 


Raspberry Pi 
with Bluetooth 


Blue Dot 
magpli.cc/ 
2qRf8EO 


Blue Dot 


Connect 


pizerow 
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BLUETOOTH 


Remove the wires from your Raspberry Pi with the Blue Dot app 


dding Bluetooth control to your projects 
has never been easier, thanks to Blue Dot’s 
app and simple-to-use Python library. The 
app’s simple blue circle can be pressed and released 
like a button, pushed like a joystick, and swiped like 
a touchscreen. 

In this walkthrough we will set up Blue Dot and 
use the remote app (on an Android device or a second 
Raspberry Pi) with the bluedot Python library to 
make lights turn on, create a DJ scratch machine, 
and add Bluetooth control to a robot. Blue Dot makes 
using Bluetooth simple, so you are only limited 
by your imagination! 


Blue Dot 


Lo!) Connected to pizeniw 


The first step is to install the bluedot Python library 
on your Raspberry Pi, so you can interact with the 
remote app. Click Menu > Accessories > Terminal 
and enter the following: 


sudo apt-get install python3-dbus 
sudo pip3 install bluedot 


The Blue Dot app for Android can be installed from 
the Google Play Store (magpi.cc/2q8wkTq). 

If you are using a second Raspberry Pi as your 
remote, you should install the bluedot Python library 
on this as well. 


Pair the device 
We need to pair the remote device running the 
Blue Dot app (the Android device or the second 
Raspberry Pi) with the first Raspberry Pi, so they 
can communicate. 

If you are using an Android device, open Settings 
and select Bluetooth to make the device discoverable. 

If you are using a second Raspberry Pi device, click 
the Bluetooth icon and select Make Discoverable. 
Now, on your first Raspberry Pi, click the Bluetooth 
icon on the taskbar, select Make Discoverable, and 
click Add Device. 

When your remote device appears, select Pair 
and follow the instructions. There are step-by-step 
installation and pairing instructions in the Blue Dot 
eetting started guide at magpi.cc/2q9cwigq. 


Left The Blue Dot app is available 
for Android and Raspberry Pi 
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Hello world 


Now that Blue Dot is installed and paired, you can write 


your first Bluetooth program. It’s a classic: when the dot 


is pressed, ‘Hello World’ will be printed to the screen. 

Open Python 3, click Menu > Programming > 
Python 3 (IDLE). Click File > New File to create a new 
program. Create your Python program: 


from bluedot import BlueDot 
bd = BlueDot() 
bd.wait_for_press() 
print("Hello World") 


Save your program: click File > Save As and save 
as mydot.py. To run the program, click Run > Run 
Module or press F5. 


Start up the remote 

Now it is time to start up the remote. On Android, 
open the Blue Dot app. If you are using a second 
Raspberry Pi, open a Terminal and run: 


python3 -m bluedot.app 
Select your first Raspberry Pi from the list of paired 
devices and press the dot. You can set functions to be 


called when the blue dot is pressed or released: 


from bluedot import BlueDot 
from signal import pause 


def say_hello(): 
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print("Hello World") 


def say_goodbye(): 
print ("Goodbye" ) 


bd = BlueDot() 

bd.when_pressed = say_hello 
bd.when_released = say_goodbye 
pause() 


Wireless light switch 

Blue Dot works really well with the gpiozero Python 
library (magpi.cc/2qd2MEb) to remotely control 
physical and electronic projects, and can be used to 
replace a gpiozero Button. 

For example, you can create a wireless light switch 
using the when_pressed and when_released 
functions with an LED. Connect an LED and resistor 
between GPIO 17 and GND (see Fig 1 on page 52), and 
create the following Python 3 program: 


from bluedot import BlueDot 
from gpiozero import LED 
from signal import pause 


bd = BlueDot() 
led = LED(17) 


bd.when_pressed = led.on 
bd.when_released = led.off 
pause() 


BLUE DOT 
POSITION 


The Blue Dot 
touch position 


also includes 
the x and y 
coordinates, 
distance and 
angle from 
the centre. 


SOURCE 
& VALUES 


Many gpiozero 


objects have 
a source 


property to link 


components 
together 
with a values 
property, 
including 
Blue Dot. For 
example: 
led.source 


= bd.values 
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ALLOW 
PAIRING 


You can make 


your Raspberry 
Pi discoverable 
and pairable 
for 60 

seconds with 
bd.allow_ 
pairing(). 
This is useful 
when adding a 
new remote. 


INTERACTIONS 


db.interaction 
will return all 
the details 
about what 
happened 
between the 
Blue Dot 

being pressed 
and being 
released. 


Run the program and connect the Blue Dot app to 
your Raspberry Pi. Pressing the blue dot will turn on 
the LED, and releasing it will turn it off. 


Control a robot 

The Blue Dot app can detect exactly where the dot 

has been pressed. Using this information, the dot can 
act as a joystick to control a robot. Pressing the dot 

at the top will make your robot move forward, while 
pressing it on the right will rotate the robot clockwise, 
and so on. 

Replace the LFpin, LBpin, RFpin and RBpin 
variables with the Left Forward, Left Backward, Right 
Forward and Right Backward pins which control your 
robot’s motors: 


from bluedot import BlueDot 
from gpiozero import Robot 
from signal import pause 


bd = BlueDot() 
robot = Robot(left=(LFpin, LBpin), 
right=(RFpin, RBpin) ) 


def move(pos): 
if pos.top: 
robot. forward() 
elif pos.bottom: 
robot .backward() 
elif pos.left: 
robot.left() 
elif pos.right: 
robot .right() 


def stop(): 
robot.stop() 


bd.when_pressed = move 
bd.when_released = stop 


pause() 


At the moment, the robot’s direction only changes 
when the dot is released and pressed again. To change 
it so that the direction also changes when the touch 
position is moved, use when_moved: 
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Fig 1Setup 

your Bluetooth- 
controlled LED 
as shown here, 
connected via 

a resistor to 
GPIO 17 and GND 


bd.when_moved = move 


DJ scratch machine 
You can swipe the dot as well as pressing it, as if you 
were moving between images in an app. 

In this program you will create a DJ scratch machine 
which will play a beat in a loop, and a vinyl scratch 
when the blue dot is swiped: 


import pygame 
from bluedot import BlueDot 
from signal import pause 


pygame.mixer.pre_init(buffer=512) 
pygame.init() 
pygame.mixer.init() 


loop = pygame.mixer.Sound("/opt/sonic-pi/ 
etc/samples/loop_amen. flac" ) 

scratch = pygame.mixer.Sound("/opt/sonic- 
pi/etc/samples/vinyl_backspin. flac" ) 


def scratched(): 
scratch.play() 


bd = BlueDot() 
loop.play(loops = -1) 
bd.when_swiped = scratched 
pause() 


The direction in which the dot is swiped can also be 
used by checking the variable that is returned by the 
when_swiped function: 


from bluedot import BlueDot 
from signal import pause 


def swiped(swipe): 

if swipe.up: 
print("up" ) 

elif swipe.down: 
print ("down") 

elif swipe.left: 
print("left") 

elif swipe.right: 
print("right" ) 


bd = BlueDot() 
bd.when_swiped = swiped 


pause() 


More ideas 

You’ll find a full getting started guide with lots more 
ideas, as well as acomplete API reference, in the Blue 
Dot documentation (magpi.cc/2qRf8EO). 
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Code Club is a nationwide network of volunteer-led after school clubs 
for children aged 9-11. 


We're always looking for people with coding skills to volunteer to run 
a club at their local primary school, library or community centre for an 
hour a week. 


You can team up with colleagues, a teacher will be there to support 
you and we provide all the materials you'll need to help get children 
excited about digital making. 


There are loads of ways to get involved! 


So to find out more, join us at www.codeclub.org.uk 
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Collect and display environmental data using the Sense HAT 


Sense HAT 
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and Wolfram’s language function 


ver since the partnership between the 
Raspberry Pi Foundation and Wolfram 
Research began, people have been excited to 
discover — and are often surprised by — the power and 
ease of using the Wolfram Language on a Raspberry Pi. 
The Wolfram Language is particularly useful in 
partnership with the Sense HAT, which features an LED 
array and a collection of environmental and movement 
sensors. These give users the ability to read in data 
from the physical world and display or manipulate 
it in the Wolfram Language with simple, one-line 
functions. With the release of Mathematica 11, Wolfram 
Research has been working hard to refine functions 
that connect to the Sense HAT, allowing Mathematica 
to communicate directly with the device. 


Programming the Sense HAT 

The Sense HAT’s functionality is built on Wolfram’s 
Device Driver Framework (magpi.cc/2sl]5Q5u), so 
connecting to the device is incredibly simple. To 
start, use the DeviceOpen function to establisha 
connection. This will return a DeviceObject, which 
we will use later to tell Mathematica which device 
we want to read from or write to. 


hat = DeviceOpen[ "SenseHAT" ] 


In the case of the Sense HAT, there are three on- 
board sensors that Mathematica can read from. 


To access the data from these sensors, simply call 
DeviceRead with the name of the measurement 
wanted. For instance: 


temp = DeviceRead[hat, "Temperature" | 
hum = DeviceRead[hat, "Humidity" ] 


A total of seven measurements can be read from 
the Sense HAT: temperature, humidity, air pressure, 
acceleration, rotation, magnetic field, and orientation. 
All the readings are returned with appropriate units, 
making it easy to convert the values to other formats 
if necessary. 


accel = DeviceRead[hat, "Acceleration" ] 
accelSI = UnitConvert[accel, 
"Meters"/"Seconds"*2] 


The other physical component of the 
Sense HAT is the 8x8 LED array. You can use 
the DeviceWrite function to send an image or 
a String to the array. For strings, the text scrolls 
sideways across the device. You can set the speed and 
colour of the scrolling text. 


DeviceWrite[hat, "Hello, world!"] 


DeviceWrite[hat, {"Now in color!", 
"ScrollSpeed" -> @.25, "Color" -> {255, @, 128}}] 


raspberrypi.org/magpi 


Alternatively, the Sense HAT can receive an 8x8 list 
of RGB values to be displayed on the LED array. Using 
this method, it is possible to display small images. 
Download and run the code from magpi.cc/2slmDoa 
to see a display like the one in Figure 1. 


Practical uses 

Using these functions, you can write Mathematica 
programs that process the data received from the 
sensors on the Sense HAT. For example, at the 
Wolfram Technology Conference in October 2016, 
the Sense HAT was demonstrated by reading the 
temperature, humidity and air pressure around 
the Pi every five minutes, and pushing that data to 
the Wolfram Data Drop (magpi.cc/2sIL7hF). 


db = CreateDatabin[ | 
SaveReadingToDataDrop[ 
bin Databin] := (Module[{dev, hum, temp, 


pres}, 
dev = DeviceOpen["SenseHAT" J; 
temp = DeviceRead[dev, "Temperature" ]; 
pres = DeviceRead[dev, "Pressure" ]; 
hum = DeviceRead[dev, "Humidity" |; 


DatabinAdd[ 
bin, <|"temperature" -> temp, 
"humidity" -> hum, 
"air pressure" -> pres|>]; 
DeviceClose[dev];]); 
cronTask = RunScheduledTask[ SaveReading 
ToDataDrop[db], 300] 


This function generates a new databin to store data, 
but what does that data look like once it has been 
recorded? Let’s look at the recordings made at the 
Wolfram Technology Conference (Figure 2). 

That data was available to be downloaded into 
Mathematica by anyone, at any time after the 
conference, to show the changes in atmospheric 
conditions using DateListPlot. 


DateListPlot[Databin[ "gwSkMvMW"]]["“air 
pressure" | 


Figure 2: Air pressure readings taken by a Sense HAT at the 
Wolfram Technology Conference 2016 


raspberrypi.org/magpi 


MATHEMATICA AND THE SENSE HAT 


In Figure 2, you can see the rise in air pressure 
inside the conference centre as more people gathered 
to see the demos from Wolfram employees, followed 
by a drop as the conference ended. 

Another demo run at the conference made 
use of DeviceWrite. Using the Wolfram 
Language’s financial database, the Sense HAT was 
transformed into a miniature stock ticker. This 
demo downloads the current stock market data from 
Wolfram’s servers, then picks a random stock from 
the list and shows the stock’s name and price on the 
Sense HAT’s LED array. 


>WOLFRAM 


DOWNLOAD: 


magpi.cc/2slmDoa 


StockTickerPi[ 
dev_DeviceObject] := (Module[{len, 
price, str, stock, stockList}, 
stockList = FinancialData[ "NYSE:*", 
"Lookup" ]; 
Do[stock = RandomChoice[stockList ]; 


price = FinancialDatal[ stock]; 
If[Head[price] === Real, 
str = StringDrop[ToString[stock], 5] 


<> "$" <> ToString[ price]; 
DeviceWrite|[ 
dev, {str, "ScrollSpeed" \ 
[RightArrow] 0.05, 
"Color" -> {200, 0, 0}}]], 100];]); 
StockTickerPi[hat ] 


Let’s play qd game 

The final demo run at the conference used the Sense 
HAT’s LED array to run Conway’s Game of Life 
(magpi.cc/2sIDPKT), a famous cellular automaton. 
For those unfamiliar with the game, imagine each lit 
LED is a cell in a Petri dish. If a cell has too few or too 
many neighbours, it dies out. If an empty space has 
exactly three living neighbours, a new cell appears 
there. When these rules have been applied to all of 
the spaces on the grid, a new ‘generation’ begins, 
and the rules are reapplied. This pattern can continue 
indefinitely, given the right conditions. In the demo, 
a random array of lit and unlit LEDs constitutes the 
Starting pattern. The automaton then runs for a given 
number of iterations. 

Check out the code download to see how this was 
done. The rounds, pause, and color parameters can 
all be modified to change the way the automaton is 
displayed, and to adjust how long Mathematica waits 
before displaying the next iteration. 


What next? 


This is only a taste of what is possible with Mathematica 
and the Sense HAT. Visit magpi.cc/2slJu3N to discover 
more ideas for using them together. Once you’ve tried 
some of the ideas, why not share your work on the 
Raspberry Pi Wolfram group (magpi.cc/2slgvNo) to 
inspire other users? We’1l see you there! 
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Tutorial 


Detect a magnetic vector to ring 
your chimes with Raspberry Pi F 


recent visit to a local garden centre saw us 
musing on the collection of wind chimes. The 
designs ranged from the naff to the awesome, 
depending on how the sounds were generated, and 
that sparked the inspiration for this month’s project. f 


> Magnetometer 
HMC5883L board 


> 2x M2.5 brass 


or nylon nuts 
and bolts We had tackled electronic wind chimes many years 


back but we used individual reed switches under a 


> Magnet 
swinging magnet. This version uses a magnetometer 
> Pendulum 


assembly: to detect the pendulum’s movement, and software 
aluminium to decide when a note is triggered. Of course, being 
esions controlled by software, the sounds it could produce 
are almost unlimited. 


Selected note 


Magnetic vector 


>STEP-01 


The sensor board 


Solder the pin headers onto the 
magnetometer board. Ours came witha 
vertical header, so we swapped this for a 


right-angled one; this allowed the pendulum 
to swing much closer to the sensor. Make up 
a five-way ribbon cable lead with a socket on 
both ends to connect the sensor and the Pi. 
Mark one end of each connector with a spot 
of correcting fluid to make sure it is the right 
way round. Fix two 10 mm long M2.5 brass 
screws to the ready-drilled holes and loosely 
tighten the nuts. They need to be brass, 
aluminium or nylon screws so that they do not 
affect the magnetic field - we used brass. 


A magnetometer is a popular sensor these days. 
Often called a compass module, it is to be found 
on the Sense HAT, micro:bit, and various low-cost 
modules from many suppliers. They are used in many 
smartphones and tablets, but we always considered 
their use on a fixed computer system to be a bit 
limited, as you’re not likely to move your desk. The 
sensor is based on the magneto resistance effect first 
discovered by Lord Kelvin in 18506. He discovered that 
the resistance of metals could change in a magnetic 
field. Magnetic fields are measured in tesla, but often 
expressed in the more convenient unit of gauss, 
10,000 gauss being equal to 1 tesla. The magnetic 
field at the surface of the Earth is in the range 0.25 
to 0.6 gauss. Fundamentally, magnetic fields are 
defined by the force they exert on a moving charged 
particle. Magnetic force acts as a field, and the field’s 
strength is different in each of the three dimensions. 
Measurement of the force is in the form of a vector: a 
value that describes the strength and direction of the 
magnetic field. 

The HMC5883L module is manufactured by 
Honeywell and can be used as acompass with a 1° to 2° 
heading accuracy. It can output a 12-bit reading from 
fields of 8 to 0.8 gauss, depending on the software 
settings. We are going to suspend a magnet from a 
pendulum on a universal pivot, created by hanging 
the pendulum from a thread. In this application it 
is important to understand that we are measuring 
the two-dimensional magnetic field vector, which 
is related to the position of the pendulum, but also 
depends on the orientation of the magnet and the 
sensor. Then all we have to do is trigger the playing of a 
sound sample when certain field vectors are measured. 


Tutorial 


Raspberry Pi 
3V3 
Gnd 

GPIO 3 HMC5883L 


GPIO 2 
GPIO 4 


e 


Wind chimes in action 


Wiring 
the magnetometer 
The magnetic vector is plotted onto a 9 x 9 square board to the 
Raspberry Pi 


erid, and each of these grid points may or may not 
trigger a sound sample. Whether it does or not, 

and what sample it triggers, is selected by the user 
clicking on a grid square. The squares start off black, 


Magnetic nelds are defined 
by the force they exert on 
a moving charged particle 


indicating no sound. Clicking on them will toggle 
an associated sound on or off. The sound you seed 
in this way is set up by the number keys 1 to 9, each 
corresponding to a different sound sample. The 
magnetic field vector is plotted over the top of this 
erid. When it ends in a coloured grid square, that 
Square’s sound is triggered. 


DOWNLOAD: 


magpi.cc/1NqJjmV 


Check out Mike's 
Bakery videos at: 
magpi.cc/1NqJnTz 


>STEP-02 


| fF 


1 Metre 


15 x 15mm T - section aluminium 


M3 screws 


Build the base 


The frame is built from various lengths and profiles of extruded 
2mm aluminium. The base starts with a 235 mm section of 25 « 
15 angle aluminium. We used M5 nuts and bolts to attach it to 
a 250 x 420 mm, 12 mm thick, painted MDF base. Counter-drill 


the other side of the board so the screw heads are flush with 
the bottom of the board. The vertical upright is made froma 
one-metre length of T-section aluminium, and is attached to 

the base bracket with two M3 screws. The vertical upright is 
stabilised by two 160 mm trusses made from 15 x 15 mm angle 
aluminium. Note that the ends of these are cut off at an angle so 
that they sit flush with the other brackets. The base bracket also 


has its corners 


cut off to be flush with the trusses. 


Just a word of caution: if you are buying a HMC5883L 
module, there are some fake modules about on eBay 
that claim they are HMC5883L devices but are in fact a 
QMC5883. While the latter is a magnetic sensor, it has a 
very different internal structure, different capabilities, 
and will not work with the software here. On a real 
HMC5883L, that the chip is marked L883, whereas the 
‘fake’ chip is marked DA5883. If you do get a fake, you 
should ask for a refund on the grounds that it’s not 
what was advertised. 

The HMC5883L chip has an I?C interface and runs 
from 3V3, So is easy to interface to the Pi. Figure 1 


15mm angle aluminium 


M3 screws 


beer 


5mm base fixing holes 


(page 57) shows the wiring you need. We also added a 
wire for the data ready signal, but we found that it was 
not needed for this project. Full construction details 
are shown in the step-by-step guide. 


Software 

These days it is not necessary to run as the ‘root’ 
user to access the hardware — just make sure the 
I?C interface is enabled in the Interfaces tab of 
Preferences > Raspberry Pi Configuration. 

The software, chimes.py, is written in Python 3 and 
runs under the Pygame framework. The samp1eC list 
determines the colour of each seed note and is easily 
changed if you don’t like our selection. The whole 
display size is controlled by the variables gSpace and 
gSide, making it easy to customise. An odd number 
of squares ensures that you have a central square 
position. The main loop is simple enough, but you 
might be puzzled by the small delay when a note is 
triggered. We thought it worked better like that, but 
you could remove it if you prefer an instant sound. 

The magnetic vector has a large amplitude 
when the magnet is over the sensor, but a smaller 
magnitude when it is further away. To make the vector 
measurement easier to understand, we inverted the 
value to match the movement of the pendulum. To do 
this, we took the reciprocal of the vector’s amplitude 
when we applied the scale factors. 
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160.00 


20.00 
Cantilever 
A 
Pendulum 
13 x 8 U channel 


Magnet 


85.00 
985.0 


12.00 
18.00 


T - Upright 


15 x 15mm T-section dluminium 


>STEP-03 
Build the top 


The top of the frame consists of a cantilever to hold the 
pendulum, and a supporting strut, both made from 13 x 10 mm 
U channel aluminium. The cantilever is mounted on one side 

of the T upright, and the strut on the other. From about 20 mm 
from the end of the cantilever, remove the sides of the U 
channel with a saw and file, and drill a 1mm hole about 3 mm 
from the end. Cut off the ends of the support strut at an angle of 
45° and attach it with two M3 screws. 

The pendulum is made from a 980 mm length of 13 x 8 mm U 
channel aluminium. At each end, take out the final 12 mm of the 
channel sides with a file and round the ends. Then drilla 1mm 
hole in the top, and use silicon sealant to glue a 12 mm diameter 
magnet to the bottom. 


>STEP-04 
Finishing off 


Taking it further 
You can play about with the scale factors and change Attach the pendulum to the cantilever with a strong but 

the sounds by adding other samples. However, one big flexible thread, allowing the magnet to swing just clear of the 
magnetometer and fixing screws. Make sure there are no sharp 
edges that could cut through the thread as it swings. Screw the 
whole structure to the base, sit it on a flat surface, and let the 
pendulum come to a rest. Position the sensor board so that the 


enhancement you could make is to turn on a fan when 
you detect that there has been no note triggered for 
ten seconds or so. This would be great for indoor use. 
However, you could add a bit more variety in the 
swing by taping some reed switches to the base. This 


chip is directly under the pendulum, and mark the positions of 
the two holes in the sensor board. Drill these out with a 2.5 mm 
will remove subtle amounts of kinetic energy from the drill. To mount the sensor board, slacken off the screws, push 
pendulum as it passes, and produce a more chaotic them into the holes, and then tighten up the screws. This will 
swing. We did not do anything with the Z axis of the provide you with a solid blind fixing. 

vector, So maybe you can come up with a use for that. 
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Servo motors are used to perform fine motor functions, 
and with AIY Projects you can program them for voice activation 


ne of the big hopes for AIY Drivers, is typically used for motors Oe gee sane tani 
Projects is that Raspberry and has a500 mA limit. You can ee ener ie 
Pi owners will integrate the connect wires directly to the Voice 
kit into their own projects. In our HAT hardware, but it’s easier to 
last tutorial for ATY Projects, we prototype your circuits by soldering 
ie ey | on " looked at hooking up the hardware the pins (supplied with the kit) to 
ea ie ? 4 ee ae to control an LED light (a typical the board. 
~ me = first hardware project). Here, we’re 
| de © going to take things up anotch 
Be and hook up a servo to the AIY 
a a % , Projects board. Servo motors move in a circular 
tps On the Voice HAT hardware you motion to a set position. They are 
7 will see two columns of pins. The often used to control robotic arms 
et one on the left (marked Servos) is and legs, grippers, and the position It is relatively easy to hook up 
for servos, and has a 25 mA drive of surfaces (like elevators and a servo motor to a Raspberry Pi, 
limit. The one on the right, marked rudders on an RC plane). but the ATY Projects Voice HAT 
board makes it even easier, witha 
dedicated column of pins designed 
& as cesnee ese cscs >t 2 ; ~ 8 to control servo motors. Connecting 
_ 5 fits your servos using the Voice HAT 
“¥ aes eenes i (eseescen ceeveen allows them to be controlled using 
eee ee voice commands and the Cloud 
Voice HAT of Speech API 
| eeeseee 
waa 
AA Battery ra} Servo motors are controlled using 
pitied te pulses generated by a GPIO pin on 
= Meneg yy the Raspberry Pi (we’re using GPIO 
26 on the AIY Projects Voice HAT 
seach bina = board). The servo motor expects a 
| . pulse (the GPIO pin to be turned on, 
— = oe Monee Ww or high, and then off again) every 
ADORE. scan eee ei! 20 milliseconds. The length of the 
ie fs Tae ah pulse determines the position of 
a a ale 4 e i the servo arm. If it’s 1 ms then the 
pera: ita ees 4 servo arm is rotated towards the 
wes ATi es Atte a Deis left; 1.5 ms puts it at the mid-point; 
Syrange er hee shied at 5 2 ms and it’s all the way to the 
ER at, gia As Bon right. The starting position from 
pine te iti eee Sa shi fea which servos rotate varies (and 
ae ae ae dares ee eee some move all the way around). 
wile? ELT leh ee ott ed een aes 
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The code for detecting these pulses 
and moving the servo around is 
provided with the GPIO Zero library, 
which works with AITY Projects. 


>STEP-03 

Connect the servo 

We’re using a standard 9 g micro 
servo in this tutorial. These are 
tiny 5 V servos with an operating 
voltage of 4.8 V. Each servo comes 
with three wires: usually these 
are red, brown, and orange. Red 
and brown provide power to the 
servo, and are live and neutral 
respectively, while the third wire 
detects the pulse. Make sure your 
Raspberry Pi is powered down, and 
connect the servo wires directly 
to the Servos 0 row on your AIY 
Projects Voice HAT. Many servos 
have all three wires bundled into a 
JR connector; this can be plugged 
directly into the Voice HAT board. 
Be sure to fit it the correct way 
around, with the orange/yellow 
cable in the GPIO pin on the left. 


>STEP-04 

Add Power 

The 5 V running through the GPIO 
pins on the Raspberry Pi is enough 
to power avery small servo. 
However, with this model, you are 
likely to crash the Raspberry Pi, as 
it draws too much current to power 
the motor and the Raspberry Pi 
itself. You should provide power for 
the servo from an external battery. 
Servos require 4.8-6 V DC power to 
the motor, which can be provided 
from a 4xAA battery pack. Connect 
the red wire to the positive terminal 
on the Voice HAT board, and the 
black wire to the negative. 


ATTACH A SERVO TO AIY PROJECTS 


Above: A servo motor measures the length 
between pulses (a GPIO pin being turned rapidly 
on and off). When the pin is on for 1 ms, the 
servo moves to the low position. When it's on for 
2 ms, it moves to the high position. Other pulse 
lengths are used to set it between low and high 


>STEP-05 

Test it out 

Before coding the servo to respond 
to your voice commands, you can 
test the circuit using GPIO Zero 

in Python. Open IDLE 3 and enter 
the code from servo.py. Save the 
code and press F5 to runit. The 
servo will move from its minimum 
position to the mid-point, and 
then to the maximum position 
with a pause between each step. 
Press CTRL+tC to quit the program 
and stop the movement. If the 
servo doesn’t work, double-check 
your connections. 


>STEP-06 

Integrate with voice 

Now that the servo is working, it’s 
time to integrate it with the AIY 
Projects code by modifying the 
action.py script. Open the latter 
in TextEdit: 


xdg-open /home/pi/voice- 
recognizer-raspi/src/action.py 


Now add the code from 
add_to_action.py to the ‘actions’ 
and ‘voice command?’ sections 
(highlighted as comments in the 
code). Run src/main.py and press 
the button on your AIY Projects 
Voice HAT board. Now say “change 
to minimum” or “change to 
maximum” to move the arm up 
and down. Saying “change” and 
any other command moves the 
arm back to the middle. 


Tutorial 
qanguage 


>PYTHON 


from gpiozero import Servo 
from time import sleep 


class ServoMove(object): 
def _init (self): 
self.servo = Servo(26) 
#self.value = value 


def run(self, voice command): 
if ‘maximum’ in voice command: 
self.servo.max() 
elif ‘minimum’ in voice command: 
self.servo.min() 
else: 
self.servo.mid() 


actor.add keyword('change', ServoMove()) 


return actor 


GPIO ZERO 


Our code uses the 
GPIO Zero Python 
library to control 


Seruc.py 


from gpiozero import Servo 
from time import sleep 


the servo. You can 
learn more about 


SaMel = Servo(26) controlling projects 

while True: . with GPIO Zero in 
servo.min() our Essentials book, 
sleep(1 ) Simple Electronics 
servo.mid() with GPIO Zero: 
sleep(1) magpi.cc/2bA3ZP7 
servo.max() 
sleep(1) 


Maghi 


Now everything is working, you 
can attach the servo to the side of 
the kit’s cardboard box. On the side 
of the kit, you’ll see an arc-shaped 
hole. Most small servos will fit in 
this space. Twist the servo to lock 
it in place. Try adding a wooden 

or 3D-printed arm to the servo so 
you can clearly see it moving. 
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Connect 


n our recent AIY Projects 

tutorials, we’ve looked 

at how to move beyond 
using the Voice Assistant, and 
towards using your Voice HAT 
with basic electronics. 

If you’ve been following our 

tutorials, you will have discovered 
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a motor to your AIY Projects Voice 
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how to connect the Voice HAT 
hardware to simple circuits. So far 
we’ve looked at how to control LED 
lights and servo motors, but in this 
tutorial we’ll look at something 

a little more complex: using the 
AIY Projects Voice HAT to control 

a motor. 
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The first thing you need to do is 
isolate the Raspberry Pi’s power 
supply from the power on the 
Voice HAT board. This will prevent 
the DC motor from draining too 
much power and shorting out your 
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from gpiozero import PWMOutputDevice 


class MotorMove(object): 
def _init (self): 


def run(self, voice command): 
if ‘on’ in voice command: 


self.pwm.on() 


self.pwm = PWMOutputDevice(4) 


elif ‘off’ in voice command: 


self.pwm.off() 


return actor 


Raspberry Pi. Locate the external 
power solder jumper marked JP1 
(just to the left of Servos 5 on the 
Voice HAT board). Use a utility 
knife to cut the connection in the 
jumper (you can always re-solder 
this joint if you wish to share the 
power between the board and the 
motor again). 


>STEP-02 

Power off 

Make sure your Raspberry Pi 

and Voice HAT board are powered 
off. Now connect the positive leg 
of the DC motor to the middle 
pin on Drivers Oo. Notice that at 
the bottom of the Driver pins 

is a ‘+’ symbol. 


>STEP-03 

Wire for power 

Next, connect the negative wire 
of the motor to the ‘-’ pin on 
Drivers 0 (the pin on the right). 
You may have noticed that 
we’re not connected to the GPIO 
Pin on the left (which is GPIO4); 


actor.add keyword('motor', MotorMove()) 


this doesn't matter as it also 
controls the negative ‘-’ pin 
that we have just connected to. 
This allows us to turn the motor 
on and off. 


>STEP-04 

Power up 

Finally, connect the 4xAA battery 
pack to the +Volts and GND pins 
at the lower left-hand corner 

of the Voice HAT. This pack will 
ensure that the motor has enough 
power when you are using the 
Voice HAT, which will prevent 
your Raspberry Pi from crashing. 
Connect the power and turn on the 
battery pack. 


>STEP-05 

Turn on the Pi 

Now turn on the Raspberry Pi 
and boot into the AIY Projects 
software. Enter the code from 
motor.py to test the circuit. 

We are using PWMOutputDevice 
from GPIO Zero to control 

the motor. This enables us to 
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from time import sleep 


pwm = PWMOutputDevice(4) 

while True: 
pwm.on() 
sleep(1) 
pwm.off() 
sleep(1) 
pwm.value 
sleep(1) 
pwm.value 
sleep(1) 
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manage the speed of the motor 
(magpi.cc/2tnAGrz). We can use 
the .on() and .of f() methods 
to start and stop our motor. 
Alternatively, we can set the 
value instance variable to a value 
between 0.0 and 1.0 to control the 
speed. Both techniques are shown 
in the motor.py code. You can 
also use pwm. pulse() to pulse 
the motor on and off. 


>STEP-06 


Hook it up to 

the Voice Assistant 

Now that we’ve seen how to 
control the motor using GPIO 
Zero, it is time to integrate it 
with the Voice Assistant. Enter 
the code from add_to_action.py 
to the relevant sections of 
/home/pi/voice-recognizer- 
rasp1i/src/action.py and run 
src/main.py. Push the button 
on your Voice HAT board and say 
“motor on” to start the motor 
running; push the button again 
and say “motor off” to stop it. 
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from gpiozero import PWMOutputDevice 
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Email magpi@raspberrypi.org or 
find us on raspberrypi.org/forums 
to feature in a future issue. 
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Does it run on Windows/Mac? 

The Raspberry Pi is a full computer so you don’t need 

to run it on another computer — it runs itself. You can 
use any other computer system to set it up, though, 

by installing operating systems to the SD card, or by 
transferring files from one to the other with a USB stick. 


Which Raspberry Pi do you recommend? 

The Raspberry Pi 3 is the flagship model, and the 

most powerful version. It also comes with built-in 
wireless LAN and Bluetooth, as does the Raspberry Pi 
Zero W. The latter is very small, but not as powerful as 
the Raspberry Pi 3. A lot of Raspberry Pi projects will 
work on both models. The other models are cheaper 
than the Pi 3, but are not as powerful and don’t have 
wireless LAN or Bluetooth built in. 


Do | need a case? 

Not necessarily. The Raspberry Pi is pretty tough, but 
don’t use it on a metal table while it’s naked. Cases 
are generally very cheap and come in an assortment 
of styles for all types of Raspberry Pi, so there’s no 
reason not to get one. 


The light comes on but the screen is black 

The most common cause of a black screen is that the 
SD card is blank, hasn’t been written to properly, or is 
just not pushed in all the way. Disconnect the power, 
make sure the SD card is pushed in, and try again. If 
that doesn’t work, download the operating system 
again and reinstall it. 


There’s a rainbow square in the corner 

If you’re seeing the rainbow square, it’s the Raspberry 
Pi letting you know that it isn’t receiving enough 
power. If the Raspberry Pi is performing well, you 


can probably ignore it, but if add-ons aren’t working 
or programs are running very slowly, you’ ll need to 
upgrade to a 2.5 A micro USB power supply. 


What's the user name and password? 

The default user name on Raspbian is ‘pi’, and the 
password is ‘raspberry’. This is the same on every 
Raspberry Pi running Raspbian, so you should change 
the password in the Raspberry Pi Configuration 
settings. These can be found in the menu in the top 
left-hand corner of the screen. 


What do | need to run a Raspberry Pi? 

At the very least, you need an SD card, mouse, 
keyboard, monitor, and power supply. For older 
Raspberry Pi models you’1l need a WiFi dongle or a 
wired internet connection. With some tweaking, if 
you need to, you can run your Raspberry Pi without a 
monitor, mouse, or keyboard. 


What size SD card should | use? 

Physically, you need a microSD card for almost all 
versions of the Raspberry Pi. The original Model B and 
Model A require a full-sized SD card. We recommend 
an 8GB card so that you have plenty of room to install 
your choice of operating system. 


What else do | need for a Raspberry Pi Zero? 
You’ ll need a micro USB (male) to USB A (female) 
adapter. A small USB hub will allow you to connect a 
few devices. You may also need an adapter for the mini 
HDMI port. Alternatively, look for cables that connect 
from mini HDMI straight to HDMI with no dongles or 
converters necessary. 
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YOUR QUESTIONS ANSWERED 


FROM THE RASPBERRY PI FAQ 


RASPBERRYPI.ORG/HELP 


resources for independent and informal learning. We also 
offer free online training materials for educators and other 
interested users. Find our resources at raspberrypi.org. 


Does the device have support 

for any form of netbooting or PXE? 

Yes. The Raspberry Pi 3 can be set up to network-boot 
without an SD card present. Earlier models can PXE/ 
netboot with an appropriately set up SD card. 

There is also PiNet, which is a free and open-source 
community-based project initially designed for schools. 
Each Raspberry Pi boots from a small set of startup files 
on an SD card, and fetches the rest of the data it needs 
from the PiNet server, thereby allowing you to maintain 
a single operating system image for all the Raspberry Pis 
on the network. PiNet also adds network user accounts, 
shared folders, and automated backups. 


What educational material is available? 

For children, we particularly recommend Adventures in 
Raspberry Pi, a book by Carrie Anne Philbin, who works 
with us at the Raspberry Pi Foundation. On our resources 
pages we offer free educational materials; you'll find 
complete schemes of work linked to the curriculum 

for England, Wales, and Northern Ireland, as well as 


WD PIDRIVE FOUNDATION EDITION 


MADE FOR RASPBERRY PI 


Our custom NOOBS software enables you to install 
multiple work spaces for up to § projects that can all be 


managed from the WD PiDrive. 


© wDLaBs 


Includes microSD™ card 
with starter software 


$18.99 


BGA: Ball grid array. A type of surface-mount 
packaging for electronics. 

Brick: To accidentally render a device inert by making 
changes to software or firmware. 

Distro: A specific package (‘flavour’) of Linux and 
associated software. 

GPIO: General-purpose input/output. A pin that can 
be programmed to perform a wide range of tasks. 

GPU: Graphics processing unit. The hardware that 
handles the graphics. 

PoE: Power over Ethernet. Enables a device 
to be powered via an Ethernet cable. 

PXE: Preboot execution environment. A way 
to set up a device to boot via the network. 

SoC: System onachip. A computer on a single chip. 


Includes microSD™ card with starter 
software and WD PiDrive Cable 


Starts at $28.99 


Learn more at wdlabs.io/mp59b 


Western Digital, WD, the WD logo, WDLabs, and the WDLabs logo are registered trademarks or trademarks of Western Digital Corporation or its affiliates in the U.S. and/or other countries. Raspberry Pi is a trademark of the Raspberry 
Pj Foundation. microSD is a trademark of SD-3C, LLC. All other marks are the property of their respective owners. As used for storage capacity, one gigabyte = one billion bytes. Total accessible capacity varies depending on operating 
environment. Product specifications subject to change without notice. Pictures shown may vary from actual product. © 2017 Western Digital Corporation or its affiliates. 


FOLLOW MISSIONS 


LEARN PROGRAMMING ~ 


a sl ah - « 
ee Bl > ° ’ 7 
’ ws i 5 - 
vas « ; or 
soe i Bhatia: / hs 
or } 


2ER COMPUTER KIT 


ps 


s ene ct i ’ ie ta tee ret aA Reoxs 4 7 ll . ore = — 
. ai TO DUTE At Tec = an oaing — 
‘ 


Special $10 MagPi coupon: 


only at BuildPiper.com 


‘It’s a really fun educational computer kit 
that should really impress those who love 


Minecraft and building stuff” Mii é 
agPi 


Want to learn how to bring Piper to your school? 


buildpiper.com/EDU 


THE PIPER EXPERIENCE 


> 
SOFTWARE-BASED CURRICULUM CREATE YOUR ELECTRONICS 


¢ 


Supported by Top University Funds 
Stanford-StartX Fund 
AEF of Princeton University 


Available at: 
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ummer’s here, so why 

don’t you unplug your 

Pi and go outside? Use a 
battery pack to take your Pi with 
you, of course! In this issue, we 
celebrate the great outdoors with 
twelve ideas you can use to make 
the most of the (hopefully) good 
weather. You’1l see how to build 


a weather station, how to launch 
a high-altitude balloon witha 
Raspberry Pi tracker, and how to 
photograph the wildlife in your 
garden with hidden Pi-powered 
cameras. If you’re a sporty type, 
we’ve got some upgrades for 
your bike or skateboard too. 
Let’s go! 
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PETER KODERMAC 


Peter Kodermac is a technology 
enthusiast from Slovenia. All of 
his Pis are always hard at work. 
raspberryweather.com 


Temperature sensor Pi Cobbler breakout cable 

The DS18B20 is a waterproof temperature The Pi Cobbler breakout cable connects 
sensor that gives consistent and fast all the GPIO pins to the breadboard, ome rain or shine, a 
results. You could use the DHT22 sensor making it easy to connect the sensor weather station makes 
instead, which also measures humidity to the pins on the Raspberry Pi 


a great project for your 
; ; Raspberry Pi. With a budget of 
0 oe oS elaletate tes aati around $100, Peter Kodermac built 
a Pi-powered weather station 


that captures temperature data, 


ayreeeeeoeeee 


————_ eraphs it, and publishes it online. a 

Siig His website provides step-by-step a ae 
instructions to walk you through , 

By the process, which involves some t 


simple wiring, and setting up the 
Raspberry Pi as a web server. A 
For the sensor, Peterrecommends (|i 


doesn’t measure humidity, so if 

Protect your Pi from the rain. The plastic lid you want to track humidity, try 

and wooden roof are not shown here. This the DHT22 instead. Peter warns 

Pi is externally powered, but you could use that the DHT22 tends to give less 

a sealed Pox wititia Battery Inside consistent values and can take more . 
than one attempt to get a reading. | 


Plastic box 


the DS18B20. It’s waterproof and . 
comes with a long cable so you 

can keep the sensor away from . \ 
the weather station, which might | WS 
generate heat. The DS18B20 » ' 
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YO UJ ’ | [ N FE FE D @ Raspberry Pi © Breadboard @ DS18B20 or DHT22sensor © Plastic box 
© 47 kQ resistor © Adafruit Pi Cobbler breakout kit (26- or 40-pin) 
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Peter’s code, available through 
GitHub, is designed to compensate 
for that, automatically retrying 
where necessary. 

Peter uses a Pi Cobbler breakout 
cable and a breadboard to make 
it easy to connect the sensor to 
the Raspberry Pi. Make sure you 
buy the correct Cobbler cable for 
the model of Raspberry Pi you 
are using! Everything is housed 
in a plastic food box, with a hole 
for the power cable to go in, and 
for the sensor cable to come out. 
A wooden roof offers shelter, 
and Peter puts silica gel sachets 
inside the box to offer additional 
protection from moisture. 

There were several stages 
involved in setting up the 
software for Peter’s project. 
First, he installed MySQL and 
used it to create a database for 
WordPress, which he uses to 
store the weather data. Then he 
installed and configured Apache 
and WordPress. He installed the 
Raspberry Weather plugin for 
WordPress, to generate a graph 
of the latest temperatures when 
anybody viewed the webpage. 
Finally, he used a Python script 
to query the sensor and put its 
data into the database, and Cron 
to schedule the script to run every 


A a a ee a a 
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30 minutes. “The whole process 
of setting up a web server can 
be a bit frustrating at times, but 
it is totally worth the time and 
effort,” Peter says. “It’s just 
so great to build your site from 
scratch and see other people visit 
it and give you feedback!” 

Peter has run the project 
on almost all versions of the 
Raspberry Pi. “WordPress is a bit 
of a memory hog, so the website 
loads more slowly on the Pi Zero, 
or older versions of the Pi. That’s 
why I also included a neat caching 
trick to speed up things a bit.” 

You can also monitor the 
results on your Android phone, 
using an application called My 
Weather Station. It displays the 
latest data from an XML file, 
which is updated in parallel with 
the main WordPress database. 

Since Peter shared his weather 
station design, other makers have 
added cameras, wind-speed and 
alr—-pressure sensors, and are 
calculating forecasts. If you build 
one, let Peter know. “TI have always 
felt great pride in publishing links 
to the people who have completed 
the guide,” he says. “I get a nice 
fuzzy feeling when other people 
improve my code, too — all thanks 
to open source.” 
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THREE WEATHER 
STATION PROJECTS 


MAKE A WEATHER MAP 


Even if you don’t have a weather station, you 
can access the database of Pi Weather Station 
readings, and use it to plot temperatures 

on a map using Python. 
magpi.cc/2sebENH 
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STATION HAT 
The official Weather 
Station HAT is being 
used by schools 

to record data, 
including humidity, 
pressure, and air 
quality readings, 

in an Oracle database. 
magpi.cc/2tbMCvF 


REPORT THE 
WEATHER IN SCRATCH 


Use Scratch to display your weather data, 
including a thermometer, along with a visual 
indicator for wind speed and direction. A Python 
Script is used to feed the data to Scratch. 
magpi.cc/2ssQCLK 
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DAVE AKERMAN 


Dave Akerman is a high-altitude balloonist 
who, in his spare time, is a self-employed 
software engineer working on PCs and 
embedded solutions. 

daveakerman.com 


s Neil Armstrong took a and the thin blue line of the 


| 6 ET - E R M S S 0 N 4 giant leap for mankind, atmosphere separating the 
_—— i.) he inspired one boy, eround below from the blackness 
: . Before flying your balloon in the sm watchingathome,tosendabear of space above,” says Dave. “Ona 
UK, you need to request permission. into space. clear day, with a wide-angle lens, 
from the Civil Aviation Authority at As an adult, Dave Akerman Pve had the whole of southern _— 
at least 28 days in advance. 4 launched Babbage on a high- England from Cornwall to Kent in 
Avoid areas near airports and = altitude balloon with a camera, the same shot.” 
air shows, and send an email to mm sending the teddy bear 39 km A high-altitude balloon (HAB) 
confirm (or cancel) your plans a mm oabove the Earth. Ina stunt that flight works like this: the balloon 
few days before launch. Outside replicated Felix Baumgartner’s is filled with hydrogen so it rises 
the UK, try asking for advice on } record-breaking skydive, at a speed of about 5 m/s. On 
the #highaltitude IRC channel | Babbage was released for the line between the payload 
on Freenode. 4a a free fall. and the balloon is a parachute, 
Don't launch without permission: “At that height, there’s the which is pulled closed during the 
you might endanger aircraft. f slight curvature of the Earth, ascent. After a typical flight of 
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GS YOU NEED TO 
H-ALTITUDE BALLOON 


PI IN THE SKY KIT 


You can build your own tracking 
system, but the simplest option 


mm 


CAMERA 


Using a Raspberry 
Pi with the Camera 
Module, you can 
program the 
camera to shoot at 
certain altitudes 
only. Don’t use a 


| } Raspberry Pi | 


— 
Coomera 2 


is to use the Pi in the Sky kit, case: it will trap 
which includes the GPS antenna moisture and ruin 
and a radio transmitter. your images. 


magpi.cc/2rablQk magpi.cc/28IjIsz 
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GPS tracker 

The GPS tracker has been positioned away from the Pi to 
provide a clear signal. Put your GPS aerial near the top of 4 
your container, and make sure it has an unobstructed view. | 
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BALLOON > 
The balloon (shown j 
here bursting) i 
carries your payload. 
Use the online af 
calculator to work | 


out which size you 
need: typically 800 g 
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or 1000 g, depending f 
on the weight of NM 
your payload. = 
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two to three hours, the balloon 
bursts at high altitude, and the 
payload drops. The parachute 
opens, and the payload returns 

to the ground. The payload 
includes a GPS tracker and a radio 
transmitter so you can follow its 
journey from the ground, and be 
ready to recover it. You can also 
receive images during the flight. 

There are several options for 
the radio transmissions. Most 
people in the UK use RTTY (Radio 
Teletype) transmissions, but 
some also use LoRa, a proprietary 
long-range radio system that 
enables images to be downloaded 
more quickly. In some countries 
(but not the UK), APRS can be 
used, if you have an amateur 
radio licence. 

“In the UK we have a 
widespread network of other 
hobbyists who will help during 
the flight, meaning that even if 
the chase car loses signal (e.g. 
it’s ina tunnel or on the wrong 
side of a hill) then the rest of 
the receiver network will fill in 
the gaps,” says Dave. Data from 
flights is fed into a distributed 
mapping system called Habhub. 
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Arduino Pro Mini 

This setup is a custom build, created 
without using the Pi in the Sky kit. 
The Arduino sends image data 

from the Pi to one of two radios, 
depending on which one is available. 


Insulated case 
Dave recommends plenty of insulation 
to protect your components from the 
cold, and from the impact when they 
come down to earth. It also protects 

anyone or anything your kit lands on! 


ar 


“With a well-tested radio tracker, 
the chance of not knowing where 
the payload has landed is pretty 
close to zero.” 

Dave started out building his 
own tracking and transmission 
systems, but the Pi in the Sky 
(PITS) kit can now do this for you. 
Among other things, it enables 
data from the Sense HAT to be 
sent back during the flight. 

“Some of my flights have hada 
3G link at low altitudes (useful for 
streaming video to YouTube), or 
have predicted their own landing 
position during descent,” Dave 
says. “My current project is to use 
a gliding parachute or parafoil to 
land at a particular target location, 
using wind data measured during 
ascent to feed the guidance 
algorithm during descent.” 

Dave advises new launchers 
to read as much as they can 
to avoid mistakes others have 
already made. “Read the UK 
High Altitude Society website 
(ukhas.org.uk), read various HAB 
blogs, and join the #highaltitude 
IRC channel on Freenode and 
introduce yourself,” he says. 
“Do all three!” 
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i, eS = SUPERSIZE YOUR BIKE COMPUTER 


‘ David Schneider replaced the tiny computer on 
S his bike with a Kindle Touch. Reed switches on 
the wheel and chain ring are used to measure 
' the speed and cadence. The Kindle browser 
displays the stats, which a GPS-equipped Pi 
in the saddlebag uploads to a webpage. 
magpi.cc/2tcc8ky 
Whether you’re growing flowers 
or veg, Devon Bray’s PiPlanter 
project can help. It automates 
aN. watering, based on a schedule 
Invite snails or your favourite insects to move | ee | or soil moisture levels. It also 
into anew home. Computing teacher Allen Heard ah | x monitors light and temperature, 
and his son Lincoln made a Minecraft-themed . i ! and creates a time-lapse video. 
minibeast habitat from a cereal box. A webcam : | ; _*€ = Relax on holiday, knowing the 
connected to a Raspberry Pi streams video to the —" cS plants are cared for, and watch 
iCamViewer iOS app. | , Sy their progress on Twitter. 
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BUILD A WEARABLE CAMERA : — FLY A KITE 


With these glasses, you can capture everything \ fe Want acheaper way to take 

you see, automatically taking a photo every 30 ete <i , Ly aerial photos? Richard Hayler 
seconds. A Raspberry Pi Zero inside the box a aa ee * yy sent a Raspberry Pi up on a kite. 
controls a Camera Module, and an optional Blinkt! ’ es §) §=6He used the Xtrinsic Sensor 
module flashes when a shot is taken. Cherry-pick a ; a\ | m Board to measure altitude, the 
your best shots, or turn them all into a film. ! Camera Module to take photos, 
magpi.cc/2rhBbl6 | | and mapknitter.org to combine 
the aerial shots. At maximum 
resolution with image stabilisation, 
the photos look great. 
mMagpi.cc/2s26F0a 


Photograph passing squirrels, 
woodpeckers, and partridges with 
the Naturebytes Wildlife Camera 
Kit (see our review in issue 48). 

It uses amovement sensor to 
snap pictures of passing birds and 
animals, and has a green case So it 
blends in with your foliage. 


a — 
TAKE YOUR PI ANYWHERE , MAKE 
The Zero LiPo device (see our review in issue 51) SPINNING FLOWERS 
enables you to safely power your Raspberry Pi If the weather forces you into 
from a battery pack (sold separately). Despite the great indoors, you can bring 
the name, it works with the Raspberry Pi 3, 2, y nature inside by making your own 
B+, At+, Zero, and Zero W. What will you make _ spinning flowers. Use the Explorer 
with a portable Pi? HAT with a motor and mount your 


magpi.cc/2coJyZ2 own flower design on the wheel. 
The code is in Python, and this 
makes a great first motor project. 


magpi.cc/2ralmNy 


BROADCAST BIG 
BROTHER FOR BIRDS 


Discover the secret life of birds, 

with this project to add an infrared 
camera to a bird box. When the 

blue tits move in, the Pi NoIR 

Camera Module can video them in 
black and white, by the light of an 
infrared LED. You can then stream 

your footage to YouTube. 
magpi.cc/2c8Parr | 
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Put some zip into your trips around town with an 
electric skateboard. YouTuber TheRaspberryPiGuy 
used a Raspberry Pi Zero to control an Alien Power 
System motor, and a Wii Remote to control the 
speed and acceleration over Bluetooth. He hit 
speeds as fast as 30 km/h, and he says the range 
is at least 10 km. 


OCTOCAM 


CTOCAM 


A complete camera kit with a fun design 


he latest in Pimoroni’s 
erowing range of Pi 
Zero W project kits, 
OctoCam provides everything 
you need to build your own 

cute camera. As with the other 
Pimoroni kits, the packaging is 
excellent and the hinged plastic 
case can be reused to store other 
components afterwards. 


Inside the box you’ 1] find a 
Raspberry Pi Zero W, a5 MP mini 
camera (more on this later), and 
an octopus-shaped acrylic mount 
with four suction cups and a desk 
stand. The only things you need 
to add are a microSD card anda 
power supply. Bonus components 
in the box include USB and HDMI 
adapters for the Pi Zero W, along 


i 


il 


il 


Ml 


ill il 


| 


FH 


with a50 cm USB to micro USB 
cable, a male 2x20-pin header (to 
solder on), and a sticker sheet. 
Assembly of the main camera 
kit takes around 30 minutes 
using a step-by-step guide 
(magpi.cc/2srlv2q) and is fairly 
straightforward, if a little fiddly 
at times. This is mainly due to the 
tiny nylon nuts, bolts and spacers, 
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Related 


ZEROVIEW 


Aneat custom 
mount for the 
Raspberry 

Pi Zero and 
official Camera 
Module, which 
can be stuck 
to a window 
using its two 
suction cups. 
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’ £7/$9 
magpi.cc/2e8ShWt 
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Designed for small projects 
where space is at a premium, the 
mini camera unit in the OctoCam 
kit is an unofficial device, but 
features the same 5 MP sensor 


as the original v1 Raspberry Pi 
Camera Module. Specs include a 
maximum 2592 « 1944 resolution 
for stills, and 1080p video at 30 
fps. It's also available separately 
(magpi.cc/2til50S), including a 
version without the IR filter, which 
you could to use in the OctoCam 
to make a night-vision camera. 


one of which we managed to drop 
on the floor! These fixtures secure 
the Raspberry Pi Zero W to the 
mount while keeping it far enough 
away from the camera to protect 
the latter from overheating. We 
found it a little tricky to keep the 
camera lens in the mount hole 
while folding over its short cable 
to position the Pi, but it was stilla 
lot easier than the cable-twisting 
shenanigans involved when 
assembling the rival ZeroView 
camera mount. The optional desk 
Stand is easily added, enabling you 
to sit the OctoCam ona shelf. 


Mini camera unit 

The camera itself is a third-party 
model (also available separately) 
with compact dimensions 
(60X11.4%5.1 mm). Some of the 
electronics are located on its flexible 
cable, so the end with the camera 
lens is a lot smaller than that of 

the official Raspberry Pi Camera 
Module. As it uses the same 5 MP 
sensor as the original v1 official 
Camera Module, it has similar specs 
and works straight out of the box, 
once you’ve enabled the camera 

in raspi-config on the Pi. You can 
use the standard raspistill and 
raspivid commands in a Terminal 
window, or by SSHing in from a 
remote computer. 


raspberrypi.org/magpi 


The quality of the images is 
very good, as are captured videos 
(lacking sound, of course). Sticking 
the OctoCam to a window, we soon 
managed to capture a nice time- 
lapse of the setting sun — although 
we ended up stitching the images 
together on another computer, as 
it’s a bit too much for the Pi Zero W 
to handle. 

Another obvious use for the 
OctoCam is as a CCTV security 
camera, using the motionEye OS 
operating system. Pimoroni’s 
online tutorial (magpi.cc/2srz9n6) 
shows how to set this up, including 
preconfiguring the wireless 
connection — you’ ll need to do 
this instead of starting with a 
wired connection to the router, as 
the Zero lacks an Ethernet port. 
We found the frame rate pretty 
low (2-3 fps) at anything but the 
lowest resolutions when using 
motion detection, dipping even 
lower when it started recording 
video. This appears to be due to the 
limitations of the Pi Zero and/or 
software, rather than the camera, 
as we discovered when we tried 
using a v2 Camera Module instead. 
Fortunately, if you just want to 
stream live video, turning off the 
motion detection (by activating 
the Fast Network Camera option) 
results in a decent frame rate. 


A cute, 
connected, 


camera to 


window or 
Sit on your 
shelf! 


Pimoroni 


The OctoCam's suckers stick it securely to a window 


With its compact dimensions and fun design, 
the OctoCam is very appealing. The third-party 
camera unit performs well, although the whole 
setup struggles to handle motion detection 
and recording in motionEye OS. It's also a little 


expensive, considering that you could buy a Pi 
Zero W and the standalone mini camera for under 
£24. Sure, you get a few extras in the box along 
with the mount, but you might not want them all. 
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WEB BROWSER GROUP TEST 


WEB BROWSER 
GROUP TEST 


What is the best way to surf the World Wide Web in Raspbian? 


t is hard to overstate the importance of web browsers and how 


much we take them for granted. They are our access point to 
a universe of information, and they do a lot of work to bring us all 


this information in a readable format. 


Raspbian has featured several default web browsers over the last The original Raspbian web browser, well known 
five years, changing as internet access and power requirements have as a lightweight browser for the Linux community, 
developed. Is the latest choice, Chromium, the best of the lot? We test is suitable for use on a (relatively) low-powered 
some of the best browsers available to find out. system. It hasn’t been included in standard 


Raspbian releases since around the time of the 
Raspberry Pi 2 launch, so we went into testing 
Midori on our Pi 3 expecting it to outperform 
everything else. 

Unfortunately, we were surprised to find it 
lagging as we used it. YouTube videos stuttered, and 


= : aan : 
. i re scrolling was only smooth on low-resource websites 
a] Seer. muse such as Wikipedia. Loading wasn’t particularly fast 
PI ZERO W Bd : . either. The lack of features, which should have made 
WHEN YOU SUBSCRIBE Peawet it fast and lightweight, did not seem to help, and 


this gave it a severe handicap. 


midori-browser.org 


EPIPHANY/WEB 


As with Midori, we had high expectations looking back at Epiphany. 
Known as Web in the GNOME desktop environment, it’s an often- 
overlooked browser that is usually singled out for being far too 
simplistic and basic. 

Like Midori, it was once a default Raspbian browser, with a modified 
version used until recently when it was superseded by Chromium. 
Unlike Midori, it is optimised for use with the Raspberry Pi. 

We expected our revisit to Epiphany would reaffirm our dislike for 
it, but honestly it still works well on the Raspberry Pi. Scrolling is 
relatively smooth, YouTube playback is fine, and juggling tabs is easy. 
It’s still heavily limited in what it can do, but it did a lot better than 


we expected. magpi.cc/2ruHrmX 
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CHROMIUM 


The current default browser for Raspbian, 
Chromium is the open-source base of Google’s 
Chrome browser. There’s not a lot of difference 
between the two, especially as Raspbian’s 
version has Flash installed. 

On a normal PC, Chromium is relatively 
lightweight (especially if you’re using only a 
few tabs at a time), but even this slimmed- 
down version of Chromium for Raspbian offers 
eood performance. The Raspberry Pi 3 has the 
power to handle it, and with enough oomph 
Spare to run other software. 

One of the benefits of running Chromium is 
that it also connects to your Google account. If 
you use Chrome or Chromium on your main PC, it 
lets you instantly copy over settings and apps, so 
it is easier to set up the browser to your liking. 


This is the only browser in this selection that has been made 
chromium.org specifically for Raspbian, and in fact goes beyond the definition of a 
web browser: kweb is designed to be part of a Raspberry Pi-powered 
web kiosk. 

Don’t let that deter you though, as it’s still well suited to standard 
web browsing. For people who are a bit more web savvy, kweb offers 
a range of options to customise your web browsing experience for 
maximum efficiency. This includes a button on the main interface 
that lets you turn certain features on and off, such as JavaScript, 
cookies, and more. 
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> While it can be lightning fast, you do sacrifice many of the amenities 
sa oor ie Sesh ccioersh ie of modern browsers to produce this great performance. 
FIREFOXESR === — 
There’s a bit of weird history behind Firefox on 
on Debian (the base of Raspbian), but the [ renee eee ae 
important thing is that it’s here now, and it’s in 


the form of an ESR. 

ESRs are Extended Support Releases, slightly 
different to the main version of Firefox. Firefox 
usually updates every six weeks or so, but this 
version is sent security updates only until the 
next set of major updates arrives. 


We were pleasantly surprised by the way Firefox magpi.cc/2rUZGbM 
worked on the Raspberry Pi 3. It loaded quickly, 


rendered pages well, allowed for smooth scrolling, 
and even played YouTube videos well; but what AWARD S 
made it shine was one of its lesser-known features: 
book reader mode. 

Book reader mode takes a blog-style post and 


strips the formatting down to a page with plain text C HRO MIUM 


and pictures. It reduces resource use considerably 
and works well with a Raspberry Pi, especially 
when you’re looking up tutorials or instructions. 


mozilla.org/firefox 


FIREFOX ESR 
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WD PIDRIVE FOUNDATION EDITION, USB FLASH 


Maker 
Says 
The ideal 

storage 

solution for 


Raspberry Pi 
WDLabs 


WD PIDRIVE FOUNDATION 
EDITION - USB FLASH 


Tag-team a microSD card with a USB flash dongle for extra storage. 
Lucy Hattersley looks at WD’s latest offering 


storage space. 


SAMSUNG alongside other OSes. 

64GB EVO When WD bundles a 4GB 

PLUS microSD card with one of its large 
(250GB or 375GB) hard drives, 

the advantage is clear. You geta 
much bigger storage space than 


You can pick up 
a high-quality 
microSD card 
with about the 
same amount of 
storage space 
for roughly the 
same price. 


£22 / $29 
magpi.cc/2rDv5v3 
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DLabs has produced some 
quirky and interesting 
storage solutions for the 
Raspberry Pi recently. 

The idea is simple: WDLabs has 
built a custom version of Raspbian 
that boots to an external storage 
drive. This external storage space 
then acts as the primary drive, so 
you only have to manage one single 


There are other bonuses to 
WDLabs’ software: you can install 
multiple instances of Raspbian OS 


/dev/mmcb1k@ 


would be possible with microSD 
card technology. However, what 
we have here is a microSD card 
bundled with a SanDisk Cruzer 
64GB USB drive, so things are 
a little muddier. 

For example, you can pick up 
a SanDisk 64GB microSD card for 
around the same £20 price. You 
could keep a USB port free on 


your Raspberry Pi and get a more 


TIMING CACHED 
READS: 


1118 MB in 2.00 seconds = 
558.75 MB/sec 


1140 MB in 2.00 seconds = 
570.02 MB/sec 


straightforward installation. 
What you do get, however, is 

a high-quality microSD card and 

a high-quality USB drive. And USB 

drives are typically faster than 

microSD cards (which vary in read 

and write speed tremendously — 

this is why you should choose a 

Class 6 or Class 10 microSD card 


TIMING BUFFERED 
DISK READS: 


100 MB in 3.01 seconds = 
33.21 MB/sec 


64 MB in 3.02 seconds = 
21.19 MB/sec 


from a trusted brand, like SanDisk). 
Even so, we expected the USB 
thumb drive to be faster, and 
benchmarks didn’t let us down. 


Benchmarks 

We benchmarked the WD PiDrive 
Foundation Edition, USB Flash (sda) 
against an official 8GB Raspberry Pi 
microSD card (mmblko). 

As you can see below, the USB 
Flash read was marginally slower 
with cached reads, but almost a 
third faster in buffered disk reads. 
On balance, you are getting more 
speed for the same money. 


The WD PiDrive Foundation 
Edition, USB Flash is a good 
setup for a media centre or 
retro games console. It offers 
fast read times and more 


storage than a stock card. While 
it's not quite as impressive as 
the other WD PiDrive offerings, 
it's still a useful piece of kit. 
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MINECRAFT 
p MAKER GUIDE | 


THE 08.) MONTHLY MAGAZINE WRITTEN GY AND FOR THE Pi COMMUBIT | | ll ! 


f Available on the GET IT ON 
§ App Store >> Google Play 


WITH OUR NEW 
ESSENTIALS 


AVAILABLE ON 
THE MAGPI APP! 


GET STARTED 
WITH SCRATCH 
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RASPBERRY PI 
BESTSELLERS 


Hit a roadblock in your maker project 
or business? BK have the answers. 


EAT THAT FROG? © 


Author: Brian Tracy 
Publisher: Berrett-Koehler 
Price: £11.99 

ISBN: 978-1626569416 
magpi.cc/2s38ZE8 


——— 
ee a 


Working hard without results? 
Fighting creative blockage, and 
suffering from procrastination? 
Tracy cuts through the clutter 
and gives you simple tools to 
complete your projects. Take 
back control! 


YOU DON'T HAVE TO DO IT ALONE: 
HOW TO INVOLVE OTHERS TO 
GET THINGS DONE 


__— . 
Author: Dick Axelrod et al. — a 
Publisher: Berrett-Koehler You Do} 2 
Price: £16.99 Have T° E 
ISBN: 978-1576752784 A L O N 


magpi.cc/2s2W992 


From bug fixing and testing “ae ener? 
through to crowdfunding, How 1? ay eos Pe 
makers need others. From RS Ngee 
intrapreneurs, through side | ee oe “7 
projects, to startup maker we aa 


businesses, Axelrod et al. | a 
will help you to get the right rT 
people involved. 


DON'T JUST DO SOMETHING, 
STAND THERE! 


Authors: Marvin Weisbord, 
Sandra Janoff 

Publisher: Berrett-Koehler 

Price: £16.50 

ISBN: 978-1576754252 

magpi.cc/2rj5Blh 


Getting results is often 
hindered by being in a room 

(or worse, a virtual environment) 
with people who don't 
understand your aims, and are 
hard for you to get a handle on. 
Change your approach. 
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THE INTERNET S53 every possible device to the internet 
RISKY THING S - medical devices, cars, the power 


erid — and our Panglossian disregard 
, ' for the downsides. 

Author: Sean Smit ; - F 

Publisher: O'Reilly | Blunders (‘anti patterns ); 

including those from traditional 


Sean Smith 


The Internet of 


Price: £23.99 isk Thi 
11 . 
ISBN: 978-1491963623 ee 3 ee internet-connected computer 
“Urmround Us 


magpi.cc/2rSCfPE devices, are outlined, with truly 
scary examples of connected 
devices’ vulnerabilities from recent 
years, and the case made for a more 
robust and systematic approach 

by manufacturers. Identity and 

trust, devices that outlive their 

cryptography, privacy cautions, 

business cases pulling in different 

directions from security cases: 

every angle is carefully considered 

— including law, the digital divide, 

and future human-machine 

relationships — but Smith gives no 

elib answers to the many questions 

and reflections. The beginning of 

a very necessary conversation. 


You can bury your 
head in the sand 
— or you can read 
this book. IoT devices are 
already permeating every aspect of 
our lives, yet the usual IT business 
excuses have left a vast installed 
base of unpatched and unpatchable 
software in devices we can barely 
even access, or have forgotten 
about entirely. 

Forever-day exploits are zero-day 
exploits that remain permanent 
for several years (or indefinitely). 
Patches are released, but who 
patches their ADSL router? Or 
their coffee machine? Sean Smith 
outlines the very real risks we’re 
taking with the rush to connect 


SCALA For 
THE IMPATIENT 


Author: Cay S Horstmann ee 
Publisher: Addison-Wesley g CA F A 
Price: £27.99 for the 
ISBN: 978-0134540566 
magpi.cc/22tPmMUY 


Score 


programming — and not as a bolt- 
on afterthought. Scala has obvious 
appeal for modern enterprise 
projects with large codebases, 
and Horstmann’s tutorial will 
quickly bring Java or C++ (and 
C#) coders to appreciate its 
possibilities. Scala has many 
other applications, from web 
programming to newer paradigms 
such as probabilistic programming. 
Since the first edition, there have 
been several other books on Scala, 
but Horstmann’s strengths — clarity, 
concision, and plenty of timely 
cautions about potential problems 
— combine with the latest on 
futures, concurrency, and implicit 
conversion of types, to make this a 
good choice for readers with a Java 
or C++ background. Brief but strong 
introductions on topics like pattern 
matching, and on annotations, add 
to the book’s appeal. 


Another month, 
another new edition 
of a Horstmann classic: this time 
the introduction to Scala written 
to save readers from working 
through the comprehensive but 
800-page guide from language 
creator Martin Odersky. Following 
Odersky’s conventions, chapters 
and subsections are classified by 
level for application and library 
developers, and difficult sections 
can be skipped by the truly 
impatient Scala learner. 

Scala is a statically typed JVM 
language, more expressive and 
powerful than Java, with good 
concurrency; maintaining full OO 
abilities, while adding in functional 


Score 
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PRO PYTHON 
BEST PRACTICES 


Author: Kristian Rother 
Publisher: Apress 
Price: £14.99 

ISBN: 978-1484222409 
magpi.cc/2tdxRbY 


As your Python programs 
erow, so do your problems: 
debugging gets harder; the need 
for well-written tests becomes 
more urgent; and maintenance 
issues intrude; bringing the need 
for a better approach to version 
control, code organisation, and 
documentation. Pro Python Best 
Practices is a neat exploration of 
all of these topics, which starts by 
making the case for best practices. 
Here Rother compares and contrasts 
the approaches of hacking, software 
engineering, agile, and software 
craftsmanship, coming down in 
favour of the last. 

Craftsmanship emphasises 
purpose, planning, tools, skills, 


COMPUTERS 
AND GAMES 


Pen Ww 
I pal 


Editors: Aske Plaat, 
Walter Kosters, 
Jaap van den Herik 
Publisher: Springer 
Price: £37.99 
ISBN: 978-3319509341 
magpi.cc/2rbgRIG 


Al research and the game 
of Go came to the public’s attention 
recently when Google’s AlphaGo 
program beat the world’s number 
one human player. Its combination 
of move finding by Monte Carlo Tree 
Search (MCTS) and Neural Networks 
is the pinnacle of a huge amount of 
Al research, particularly in the field 
of game playing. This collection of 
20 academic papers from last year’s 
international Computers and Games 
conference, useful reading for any 
curious reader, covers these topics 
and more. 

MCTS dominates, including the 
opening ‘Using Partial Tablebases in 
Breakthrough’, which applies Deep 
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community, and practice. Tools 
come to the fore in debugging, but 
so too does the scientific method. 
This section sees the introduction 
of a maze runner program, used 
throughout the book as the test 
bed for the methods, tools, and 
techniques taught. 

The automated testing section 
is a valuable introduction to a topic 
that many newer programmers 
put off learning. Starting simply 
with writing and running test 
functions with pytest, Rother soon 
builds through complex border 
cases to more diverse test data, 
and then to writing a complete 
test suite. Maintenance runs 
through project structure and 
refactoring, to approaches like 
defensive programming to prevent 
the unchecked propagation of 
errors allowed by dynamic typing. 
Essential material. 


Score 


Convolutional Neural Networks to 
MCTS for huge improvements in 
playing strength. Winning the Best 
Paper Award at the conference, 
Lorentz and Isaac’s research 
concludes with promising strategies 
for further refinements. 

We also find novel strategies 
and games modelling in Werewolf, 
temporal difference learning in 
2048, and Nash Equilibrium for 
better code-making choices in 
Mastermind. A few papers require 
some undergraduate maths (yours 
via various MOOCs), and things 
get a little more theoretical in the 
penultimate section. The final 
section contains a single paper 
which asks ‘Do People Think Like 
Computers’, and combines AI and 
behavioural science work for a better 
understanding of human behaviour 
and approaches in adversarial 
combinatorial games like Go. 


Score 


ESSENTIAL READING: 


MODERN PROGRAMMING 
PARADIGMS 


Beyond OO and FP, coders need to be aware 
of reactive patterns, good APIs, and more. 


Irresistible APIs 


Author: Kirsten L Hunter 
Publisher: Manning 
Price: £27.99 

ISBN: 978-1617292552 
magpi.cc/2rnXCoi 


Work across organisations to ‘Create 
Web APIs That Make Your Developers 
Weep (For Joy!)’, backed by a strong 
business case. 


Functional Reactive Programming 


Authors: Anthony Jones, 
Stephen Blackheath 

Publisher: Manning 

Price: £27.99 

ISBN: 978-1633430105 

magpi.cc/2rnzSkl 


FRP intro for Java and JS programmers, 
which should help those still baffled by 
functional programming. 


Practical Probabilistic Programming 


Author: Avi Pfeffer 
i) 


Publisher: Manning 
Price: £36.99 

ISBN: 978-1617292330 
magpi.cc/2rSPHD8 


No abstract concept, but a practical, 
predictive paradigm with strong ML 
applications, from spam filtering to 
data and image recovery. 


Reactive Design Patterns 


Author: Roland Kuhn 
Publisher: Manning 
Price: £27.99 

ISBN: 978-1617291807 
magpi.cc/2SUFV1C 


Reactive Manifesto co-author and 
Akka lead Kuhn brings message- 
driven enlightenment in logical steps. 


Visualizing Graph Data 


Author: Corey LLanum 
Publisher: Manning 
Price: £24.99 

ISBN: 978-1617293078 
magpi.cc/2rjcdx8 


Organise and present data in graph 
format, highlighting relationships in 
data, and change the questions you 
ask of the data. 
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THE MONTH IN 


Everything else that happened this month in the world of Raspberry Pi 


t’s been a couple of 
months since we released 
issue 57 with the Google 
AIY Projects voice kit, and 
we’re still seeing people make 
awesome stuff with it. One of our 
favourite websites during that 
time has been the Ktinkerer page 
(magpi.cc/2sJIZ52), which lists 
a lot of the cool mods they’ve 
EGIMme dcross lene are some 
of our faves... 


A lot of people have asked us whether ATY can connect 
to Google Music. Some clever people have worked out 
how to make it work 


GOOGLE MUSIC 


Google with Google should be a natural pairing, so 
this mod that lets you play music via Google Music on 
your AlY kit is cool. This version also includes a little 
scrolling marquee (using the Scroll pHAT) showing the 
name of the current song! 


BIBIC 
RADIO 


PLAY MUSIC FROM YOUTUBE. BBC RADIO 


We do this on our PCs sometimes - just have a soundtrack playing via Add the ability to listen to any of the major BBC Radio 
YouTube while we work. With this mod, you can add this functionality to services via the internet. This mod uses VLC, which is 
the AIY kit! You don't even have to preset any videos: it will automatically the established method. There's even a workaround for 
pick one for you. people wanting to listen to the BBC outside the UK! 
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Some basics that people have added Here are some other fun mods 
to their ATY Projects boxes for the AIY Projects kit 


ADD REBOOT AND magpi.cc /2rJTfnP 
SHUTDOWN COMMANDS 


So good that Google has merged it into the main 
AIY Projects repo, this command lets you reboot by 
saying “pi reboot”, and lets you shut it down with “pi 
power off”. Nice, simple, and you can add it yourself. 


magpi.cc/ 2sf7rcc 


magpi.cc/2rjuolM 


ADD ATIMER AMAZON DASH TRIGGERS 


One of the great things about a smartwatch is being Adding triggers to the AIY kit is a good way to expand 
able to set a timer without having to dig your phone what it does. This allows you to activate the voice 
out. This feature isn't in the AlY code, so this mod lets assistant by saying “OK Google”, rather than using 
you add it. Smart! the button. This mod goes one step further and adds 


additional buttons to the kit. 
magpi.cc/2rJBOE7 


S H UT D OWN magpi.cc/2sfbgm1i 
WITH SELF-DESTRUCT 


Shut down with a twist. You can ask the AIY Pi to turn 

itself off, or you can have it count down to turning it 

off by asking it to initiate self-destruct. It obviously BQ» 
doesn't actually destroy itself, but you know... it’s fun. 


REMOTE-CONTROL 433 
MHZ SOCKETS 


Home automation is great, especially when you 
Pp R O E ( S K] can make it work using voice activation, just like 
Star Trek. This project lets you hack some 433 MHz 


sockets with your AIY kit to do just that. 


Wanted to get a copy of issue 57 and the AIY Projects 
voice kit, but found they were sold out? We hope to 
see more kits in the near future, and you can sign 
up to our mailing list to find out when they will be 
available at magpi.cc/Email-me. 


<= i . © magpi.cc/2sePqdZ 


~~ ~' 


ee BL 
ee we 


VOICE CHESS 


Play chess against the computer using only 
your voice. You may need to lay out a real chess 


board if you can't visualise the game in your 
head. At least you'll be prepared to answer 

a chess move riddle so you can be beamed 

aboard the USS Enterprise. 
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WSa Upero ebewu| 


OMPLETE! 


The European Astro Pi competition is over, 
and the coders have the results of their experiements 


e’ll have a lot more about this in future issues 

of The MagPi, but we’re really happy to report 

that the second Astro Pi competition has come 
to an end. French ESA astronaut Thomas Pesquet 
looked after the Astro Pi units on board the space 
Station and kept an eye on the experiments as well - 
all 64 of them! 


We can see that many 
of the teams have been 
successful] in their missions antl Rettosien(Cresee right). a ans ‘ 


——— = — = 


— 


| EXPERIENCE PEDAGOGIOUE | A S.cint-André-d' Embrun (Hawbes-Alpes), des flaves travelllent! pour PSs 


On 10 May, all the results were beamed back to Nom de code ~ Thomas Pesquet 


ial" ed 
var ce 


| 

Earth, and the various student teams received them | = ~ ehtean! 
a week later to analyse and release in theirowntime. || S25 ‘aemeemae 

“We’ve looked at the results,” Astro Pi organiser - 
Dave Honess wrote on the Raspberry Pi blog | smd Ct aa coy 
(magpi.cc/2sft24g). “We can see that many of . areas me 
the teams have been successful in their missions: rod teTac ol aN 
congratulations to all of you! We look forward to scares mace mer ance ene teen 
reading your write-ups and blogs.” 

We'll show off some of the cool experiment results : 
in future issues, but for now here are some pictures nearer ane in enemmaderiie rench papers! 
from the competition. 


pe niall 
(Dewan = 
ta. Denghaan | prorat = 
} 


+ aL i 
—— = Sykes 


= —— =e . 
Laem = 


i ae sper a LA pad ven ar) Mel tole: eae : 
ae lr —_ aie = 
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KICKSTART THIS! 


Raspberry Pi projects you can crowdfund this month 


STAND FOR OFFICIAL AUDIO INJECTOR ZERO 


TOUCH SCREEN —_ = =—S—~—<“<‘:S™S 
| kek.st/2qG7Ssi Another Raspberry Pi sound card, this one is a Zero- 


sized version of the previous Audio Injector for other 


This is a Simple yet cool little Kickstarter project — a Raspberry Pi models. You can even solder on an electret 
stand specially made to hold the official touchscreen, microphone if you wish! The stretch goals determine 
along with a Raspberry Pi. It is designed to be easy to what’s going to be on the board, so you can help 
assemble, and would look great as aspecialised recipe | determine how the final product turns out. It’s a high- 
computer in your kitchen, or for showing videos at quality audio add-on for the Pi, so if you enjoy good 
events and shows. There’s even room to add a HAT! audio it’s definitely worth a look. 


BE oT OF THE RE S Here are some other great things 
we saw this month 


— RASPBERRY PI 


LOOPER/SYNTH/ 
DRUM MACHINE 


THE WORST CASE 
EVER MADE 


magpi.cc /2rwmSKf | | } m 


MINI SNES 


magpi.cc/2sf4lEW 
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Her first videos featured 

pages of notes with voice-over 
explanations of data structure and 
algorithm analysis; then she moved 


in front of the camera, and expanded 


her skills in the process 


From automated gingerbread houses to 
French press coffee at the touch of a button, 
Estefannie is taking the YouTube maker 


community by storm 


ey, world!” Estefannie 

exclaims, a wide grin across 

her face as the camera 
begins to roll for another YouTube 
tutorial video. With a growing 
number of followers, and wonderful 
support from her fans, Estefannie 
is building a solid reputation as an 
online maker, creating unique, fun 
content accessible to all. It’s as if 
she was born into performing and 
making for an audience, but this 
fun, enjoyable journey to social 
media stardom came not froma 
desire to be in front of the camera, 
but rather as a unique approach to 
her own learning. While studying, 
Estefannie decided the best way to 
confirm her knowledge of a subject 
was to create an educational video 


explaining it. If she could teacha 
topic successfully, she knew she’d 
retained the information. And so 
her YouTube channel, Estefannie 
Explains It All, came into being. 
But YouTube isn’t her only 
outlet. With nearly 30,000 
followers, Estefannie’s Instagram 
(magpi.cc/2smasrZ) game is 
strong, adding to an increasing 
number of female coders taking to 
the platform. Across her Instagram 
erid you’ll find insights into her 
daily routine, from programming 
on location for work, to behind- 
the-scenes troubleshooting as she 
begins to create another tutorial 
video. It’s hard work, with content 
creation for both Instagram and 
YouTube forever on her mind as 


° iad 


As a thank-you to her Instagram fans for helping her reach 
10,000, Estefannie created a free game for Android and 
iOS called Gravitris: imagine Tetris with balance issues! 


te 
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she continues to work and progress 
successfully as a software engineer. 
Estefannie was born and raised 
in Mexico with ambitions to 
become a graphic designer and 
animator. However, a documentary 
on coding at Pixar, and the beauty 
of Merida’s hair in Brave, opened 
her mind to the opportunities for 
software engineering in animation. 
She altered her career path, moved 
to the United States, and switched 
to a Computer Science course. 
While studying, Estefannie started 
a Computer Science Girls Club at 
the University of Houston, Texas, 
and found herself eager to put more 
time and effort into the movement 
to increase the percentage of 
women in the industry. The club 
Was a success, and still is to this day. 


approachability for all, regardless of 
age, gender or skill. From exploring 
Scratch and Makey Makey with 

her young niece and nephew, to 


Estefannies videos are 
essentially a documentary 
of her own learning process 


While Estefannie has handed over 
the reins, she’s still very involved 
in the cause. 

Through her YouTube videos, 
Estefannie continues the 
theme of inclusion, with every 
project offering a warm sense of 


HIGHLIGHT 
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creating her own Disney ‘Made with 
Magic’ backpack for a trip to Disney 
World, Florida, Estefannie’s videos 


are essentially a documentary of 
her own learning process; produced 
so the viewer can learn with her — 
and learn from her mistakes — to 


ESTEFANNIE EXPLAINS IT ALL 


Above Witha 
constant desire 
to make and to 
learn, Estefannie 
combines 

her software 
engineering 
profession 

with her hobby 
to create fun, 
exciting content 
for YouTube 


create their own tech wonders. 
Using the Raspberry Pi, she’s been 
able to broaden her skills and, in 
turn, her projects, creating a home- 
automated gingerbread house 

at Christmas, and an internet- 
button-controlled French press. 
And that’s just the beginning of her 
adventures with Pi... but we won’t 
spoil her future plans by telling you 
what’s coming next. Sorry. 

While many wonderful maker 
videos show off a project without 
much explanation, or expect a 
certain level of skill from the viewer 
who hopes to recreate the project, 
Estefannie’s videos exist almost 
within their own category. We 
can’t wait to see where Estefannie 
Explains It All goes next! 


magpi.cc/2smkomL 


July 2017 MagPi 83 


nce a year in Dublin, a horde of coding ninjas 

eather to show off their finest making skills 

at CoderDojo’s Coolest Projects event. This 
year, the event was held on Saturday 17 June at the 
Royal Dublin Society (RDS). = 


‘ OT ow 
Raspberry Pi and CoderDojo have merged, so soo me A x 
this year’s event saw an increase in the Raspberry 4 Be : S. Poise lt ——— 
Pi Foundation attendance. Pi people scoured the eas. a a =a 


show floor looking for the best and most awesome This teddy bear recognises = — =a 


‘ ) faces. We're worried that it 
projects. Here's what they saw... might be a Terminator, though... 


BN ae 
43 ee 


The Northern Ireland Raspberry Jam = tes a This LEGO robot makes the 
team ran a conductive paint Minecraft tie a cut because, unlike most 
Pi activity using the DOTS board red ai we, r »| robots, it has a driver! 


ey 


<=: 2a 


—[ Se aa 


* AT WoRK %& 


It's weird that this isn't the first beekeeping project oe i This LEGO DUPLO house is fully automated like the 
we've seen, but it is definitely the cutest i « house party scene in Home Alone 
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hat inspired you to 
volunteer for Code Club? 
“T was inspired to share 
my knowledge of computers and 
programming. In Brazil, students 
in poor neighbourhoods usually 
don’t have access to computer 
or game design courses. It is 
inspiring giving them access 
to these kinds of activities.” 


Tell us as a bit about your 

Code Club 

“On the first day of class, I 
usually show one of the games 
that the students will make 
during the course. Most of them 
do not believe they will be able to 
program something like that. It 
is extremely rewarding to me to 
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Introducing a Code Club star from Brazil 


watch the students discovering 
that they are able to develop 
those games, and even to create 
other ones based on their own 
imagination. In some cases, the 
students can even discover an 
interest in pursuing IT as a job.” 


Why is Code Club important 
to you: 

“Sharing my knowledge and 
knowing that it can change 

the future for some students is 
something priceless to me. Also, 
I have plenty of fun with it!” 


What has been your best ‘Code 
Club moment’? 

“One day, the mother of one 

of the students went to Code 
Club and she was amazed to see 
her teenage son developing a 
complete game over the course 
of two hours. She raised the 

kid by herself and she doesn’t 
have enough money to pay for 


computer/game courses for him. 


She was very grateful because 
a team of volunteers was there 
teaching and support her son.” 


Head to 


» DH Chee Vials 


facratch powered robodog at Ylanilyjam 


Nearly time for the show and tell 
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FAMILY JAM 
Building robodogs is 
all well and good, until 
they chase after the 
robo-postman! The 
Family Jam sounded 
great, though. 


RASPBERRY 
JAM GUIDE 


The Raspberry Jam 
starter kits are now out 
in the world, seen here 
with Giustina, Executive 
Director of the 
CoderDojo Foundation. 
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EVENT CALENDAR ae 


Find out what community-organised, Raspberry Pi- 
themed events are happening near you... 


HOUSTON RASPBERRY 
P| USERS GROUP 


Want a Raspberry Jam in your 
area? Want to start one? 
Email Ben Nuttall about it: 

ben@raspberrypi.org 


ee 


| pies MELBOURNE PI 
ae USER GROUP 


BUG ail Gis elb la \lelNiits REGULAR EVENTS 


FUKUOKA BECKFOOT THORNTON BLACKPOOL 
RASPBERRY PI JAM RASPBERRY JAM RASPBERRY JAM 
When: Monday 10 July When: Friday 14 July When: Saturday 8 July 
Where: Hakataeki-higashi 1-12-17, Where: Beckfoot Thornton School, Where: Palatine Library, 

Fukuoka, Japan Thornton, UK Blackpool, UK 
magpi.cc/2rQbPL4 magpi.cc/2slbfbS magpi.cc/2sIhMDp 
Hands-on demos and learning A fun evening of coding. If you A place for parents and kids to learn 
with the Pi in the first Fukuoka don’t have your own Pi, there will more about computers, electronics, 
Jam, near Hakata station. be equipment there for you to use. robotics, music, and art. 
HOUSTON RASPBERRY PI RASPBERRY JAM STAFFORD RASPBERRY JAM 
USERS GROUP MILTON KEYNES When: Tuesday 11 July 
When: Tuesday 11 July When: Saturday 15 July Where: Stafford Library, 
Where: TXRX Labs, Houston, Where: The National Museum Stafford, UK 

TX, USA of Computing, magpi.cc/2sl6BKK 
magpi.cc/2slyZMZ Bletchley Park, UK A big meetup where Pi 
An evening event where you can mkraspberryjam.org enthusiasts get together to share 
learn Pi basics and/or show off Learn about Pi at the home ideas, help each other, and most 


your Pi projects. of the world’s first computer. of all have fun! 
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FUKUOKA 
RASPBERRY PI JAM 


ry ba) %3 : ae : NS 
3 ies o” i YORK WEST 
° RASPBERRY JAM 
, 
BECKFOOT THORNTON 
RASPBERRY JAM 
BLACKPOOL 
RASPBERRY JAM 
STAFFORD 
RASPBERRY JAM 
RASPBERRY JAM 
MILTON KEYNES 
yy 
YORK WEST 
RASPBERRY JAM 


When: Monday 17 July 

Where: Acomb Library Learning 
Centre, York, UK 

magpi.cc/2sl]6bUVU 

Everyone interested in Raspberry Pi 

computers should book a place to 

learn more about the Pi! 


MELBOURNE PI USER GROUP 
When: Tuesday 18 July 
Where: Melbourne Rudolf Steiner 
School, Warranwood, 
VIC, Australia 
Magpi.cc/2mx2y7Y 
The group’s aim is to bring like- 


raspberrypi.org/magpi 


minded people together to talk about 
how they’re using the Raspberry Pi. 


HEAT MAP 


WE'VE HIGHLIGHTED SOME OF 
THE AREAS IN NEED OF A JAM! 
CAN YOU HELP OUT? 


Community 


JAMS 
EVERYWHERE! 


MORE WAYS TO LEARN 


RASPBERRY JAM 


STARTER KITS 
NOW SHIPPING 


Every Raspberry Jam can apply for gq Jam 
Starter kit, which includes magazine back issues, 
printed worksheets, stickers, flyers, and more. It 
also includes access to our new Raspberry Jam 
branding, including logo and poster templates 
for you to use to promote your events. Kits have 
started to arrive with Jams and they're going 
down a storm! As soon as you've published your 
event, you can apply for your kit. You can also 


download the guidebook here: magpi.cc/2q9DHfQ. 
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GUIDEBOOK 
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Getting AIY 


I have been away for a while and 
missed out on buying issue 57 of 
The MagPi with the AIY Projects 
voice kit. The store where I usually 
buy it was all sold out and onto 
issue 58 of the magazine, but I’d 
still like to get it — is there any 
chance of a reprint of issue 57 with 
the kit attached? 

At the very least, I’d be 
interested if you end up selling the 
kit on its own in the future. Are 
there any plans for that at all? 
Stephen 


This power socket was removed 
from the final version as it wasn't 
needed for the projects in the mag 
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LETTERS 


You will 
hopefully be able 
to buy the AIY 
Projects voice kits 
soon. Sign up to 
our mailing List to 
find out when! 


Unfortunately we won’t be 
reprinting issue 57, and even if we 
did, it wouldn’t have the kit with 
it. However, the AIY Projects Voice 
HAT kit will hopefully be for sale 
at some point, although we don’t 
know when that will be. 

The best thing you can do 
is Sign up for our mailing list. 
When Google confirms that it’s 
going to be on sale, we can let 
you know. You can sign up here: 
magpi.cc/Email-me. 


© 


AIY Projects power 

I got the AIY Projects voice kit, but after an 
inspection I’ve noticed that the power port on 
the Voice HAT, which can be seen in images in 
the magazine, seems to be missing. Can I geta 
replacement at all, or will the Raspberry Pi power 
the Voice HAT properly: 

Robin W 


The Voice HATs with the power ports were the test 
HATs we used. The power ports weren’t needed in 
the final version of the AIY Projects voice kit, as the 
Pi powers the Voice HAT, so they were taken off. You 
can easily solder one onto the board - it is useful if 
you need to supply power to accessories attached to 
the board that use more than the Pi can supply, such 
as servos and motors (see Page 62). 

Look out for a future video on The MagPi YouTube 
channel on how to program servos and motors with 
your AIY kit: magpi.cc/MagPiYT. 
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FROM THE FORUM: vicimivccrewcresayingitwasn’egoingte 
= areason why people were saying it wasn’t going to 


work - but don’t lose hope! You shouldn’t expect to 
play Crysis on your Raspberry Pi, but with a bit more 
tweaking you should be able to get something working 


; : using ExaGear. 
The Raspberry Pi Forum is a hotbed of Otherwise, DOSBox is a good alternative 


conversations and problem- solving for the (dosbox.com). You can use it on a Raspberry Pi to 


community. Join in via raspberrypi.org/ forums emulate Windows 3.1 and DOS, along with some other 
older OSes and x86 games. There’s a great tutorial online 

’m trying to find a free way to emulate x86 on my Pitosee here to show you how to use it: magpi.cc/2rMmnea. 
what it can do game-wise. All I’ve got is ExaGear and a lot 
of people say nothing’s gonna work - so if you’re gonna 

tell me it’s not gonna work, please don’t tell me that as it’s 

annoying. Anyways, if you know of any free methods that work, 

please tell me as I can’t seem to find anything. Thanks! 

Bunchie 


WD PIDRIVE THIN COMPUTE 


With a 120GB SSD and a Raspberry Pi Compute Module 3 
in a custom enclosure, the WD PiDrive Thin Compute offers 
a slim, powerful, and very small computing solution. 


The preloaded Foundation Edition starter software offers ‘i 
plug and play usability ideal for desktop computing or “SS 


more robust applications. 


° 120GB SSD « Wireless Keyboard & Mouse 
Raspberry Pi Compute Module 3 « Wi-Fi® - Dongle 
KIT INCLUDES: 
e PCBA SATA Adapter Board ¢ 3A Power Supply kit 
e Preloaded software e Custom enclosure 


© wDLABs 


Western Digital, WD, the WD logo, WDLabs, and the WDLabs logo are registered trademarks or trademarks of Western Digital Corporation or its affiliates in the U.S. and/or other countries. Raspber ark « e Raspberry 
Pi Foundation. microSD is a trademark of SD-3C, LLC. All other marks are the property of their respective owners. As used for storage capacity, one gigabyte = one billion bytes. Total accessible capacity varies depending on operating 
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IN PRINT AND DIGITAL 
FIND US ONLINE: 


www.helloworld.cc 
@® @HelloWorld_Edu 
@) fb.com/HelloWorldEduMag 
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DIGITAL MAKING _ 
EXPLAINED 
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Enter now! magpi.cc/WinJuly17 


Terms & Conditions 


Competition closes on 26 July 2017. Prize is offered to participants world-wide aged 13 or over, except employees of the Raspberry Pi Foundation, the prize 
supplier, their families or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the competition, the winner 
consents to any publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine. 
We don't like spam: participants’ details will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash 


alternative will be offered. This promotion is in no way sponsored, endorsed or administered by, or associated with, Instagram or Facebook. 
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Column = THE FINAL WORD 


he Raspberry Pi Foundation’s mission is 

to put the power of digital making into the 
hands of people all over the world. But what 
does the term ‘digital making’ mean? What kinds of 
skills and activities are included? It’s an important 
concept to understand in order to get a sense of 
what we set out to achieve — through our affordable 
computers, our outreach programs, and our support 
for educators and learners. 

In Oliver Quinlan’s Young Digital Makers, a report 
for NESTA which surveyed attitudes and opportunities 
for digital creativity across the United Kingdom, digital 
making is defined as ‘learning about technology 
through making with it’. Therefore, it’s not just about 
making something you want or need. At the core of 
digital making is the idea that an individual is learning 
when they create something with technology. 

The link between making and learning is well known 
and its implementation in education is widespread 
worldwide. MIT Media Lab’s Seymour Papert pioneered 
the learning theory of constructionism in the 1980s 
in his book, Mindstorms. Constructionism is the 
concept that people learn about a subject by creating 
something physical. In Papert’s own words, “learning 
is most effective when part of an activity the learner 
experiences as constructing a meaningful product.” 


The first step 

With technology like the Raspberry Pi becoming more 
accessible and affordable, it can become a material 
for digital making. Computers are typically thought of 
as tools for creating, but Papert had also envisioned 
computers being used as a material in projects. 
Products like the Raspberry Pi Zero are perfect as a 
material. The Zero is a powerful computer, and yet it’s 
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MATT RICHARDSON 


Matt Richardson is the Executive Director of the Raspberry 
Pi Foundation North America and author of Getting Started 
with Raspberry Pi. Contact him on Twitter @MattRichardson. 
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What exactly is digital making? Matt Richardson explains 


so affordable that it can be dedicated to a single project, 
no matter how simple that project is. Imagine creating 
a computer-based project just 15 years ago; it would 
have been very expensive! 

The beauty of digital making is that when you 
practise it, not only are you learning through the 
process of making, as Papert theorised, but you’re also 
gaining valuable STEM skills that are almost certain to 
come in handy in the job market. Developing a better 
understanding of code and electronics is a valuable 
skill in and of itself, and a skill that is likely to be 
increasingly in demand in the future. 

While we tend to put a focus on learning among 
schoolchildren, I should also note that learning 
through digital making doesn’t only happen 
with students in a classroom. Learning happens 
in libraries, museums, scout meetings, and 
makerspaces. It also happens in home garages and 
workshops. Learning through digital making doesn’t 
only happen with young people, but people of all ages. 

When I try to define digital making in my own 
words, I often tell people that it’s a blend of a lot of 
different subject matters: computational thinking, 
coding, electronics, physical computing, design 
thinking, fabrication, project-based learning, and 
sharing. I know that’s a lot of big stuff packed into one 
term, but digital making is a big thing and I suspect it 
is only getting bigger. 

When we say that we want to put the power of 
digital making into the hands of people all over the 
world, we’re taking on an ambitious task, and we have 
a lot of work ahead of us. Thankfully, digital making 
is also a fun and fulfilling activity. We only have to 
provide the affordable computers and free resources: 
the rest is up to you, digital makers! 
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ESSENTIALS 
LEARN | CODE | MAKE 


OUT NOW IN PRINT 
ONLY £4/86 
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™ 


Build your own credit card 
sized computer 


Get started with Programming 
Set up a Media Center 
Make simple electronic circuits 


Raspberry Pj board and case 
Power Supply and HDMI Cable 
Pre-Programmed Memory Card 
Over 40 electronic Parts 
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Available for worldwide shipping at: 
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Available in Europe 
through RS Components 


$89” £69°° 


US DOLLARS EXCLUDING VAT 


Raspberry Pi is a registered trademark of the Raspberry Pi Foundation. 
For Dummies and the Dummies Man logo are trademarks or registered 
trademarks of John Wiley & Sons, Inc. Used under license. RS logo is 

a registered trademark of RS Components Ltd. CanakKit is a registered 
trademark of Cana Kit Corporation. 


ELECTRONIC KITS e ELECTRONIC PARTS e RASPBERRY PI ¢ ARDUINO 


